Export API is a cloud-based API meant to export the data from the iModels to other standard formats such as IFC or LandXML. It allows users export data from iModels which are hosted in Bentley's iModelHub to an IFC or LandXML file.

export

Initial technology preview release of the API.

Added technology preview operation 'Get ExportConnection Run'.

Added technology preview operation 'Get ExportConnection Runs'.

Added technology preview operation 'Create ExportConnection Run'.

Added technology preview operation 'Create ExportConnection'.

Added technology preview operation 'Get ExportConnection'.

Added technology preview operation 'Delete ExportConnection'.

Added technology preview operation 'Get ExportConnections'.

---

Retrieves the calling user's Authorization Information.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `export:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---

get-authorizationinformation

URL to redirect back to after authorization

redirectUrl

OAuth access token with scope `export:read`

Authorization

Setting to `application/vnd.bentley.itwin-platform.v1+json` is recommended.

Accept

default

This response indicates that request lacks valid authentication credentials. Access token might not been provided, issued by the wrong issuer, does not have required scopes or request headers were malformed.

HeaderNotFound

application/json;InvalidAuthorizationScheme

InvalidAuthorizationScheme

InvalidHeaderValue

RequiredScopeMissing

Unauthorized

Invalid request to get authorization information.

This response indicates that the user has sent too many requests in a given amount of time.

The number of requests exceeds the rate-limit for the client subscription.

retry-after

---

Create a ExportConnection that describes which iModel's data is to be exported.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `export:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

### Associated entities

A connection is linked with an iModel. An iModel ID is required to be set when creating a ExportConnection.

---


create-export-connection

Indicates request body content type. Supported media type is `application/json`.

Content-Type

OAuth access token with scope `export:modify`

Invalid request to create connection. Request payload might be missing some of the required properties.

application/json;InvalidExportConnectionRequest

InvalidExportConnectionRequest

MissingRequestBody

---

Runs the specified ExportConnection.

### Notes

1. The export process usually takes time and is performed in the background. For that, we need to store the user's refresh token. The refresh token needs to be stored before calling the 'Create ExportConnection Run' end-point. You can get authorization information by using [Get Authorization Information API](https://developer.bentley.com/apis/export/operations/get-authorizationinformation/). This API will return the current status and a redirect URL if the token has to be renewed.

2. When a run is successfully created, the operation returns HTTP status code 202/accepted - the request is accepted for processing and will execute in background. The response will include a location header pointing to the created run. If an existing active run already exists for the iModel, a new run is not initiated, instead 303/see other is returned along with location header pointing to that existing active run. 
In the rare event that multiple create run requests are being made simultaneously, only the first request is processed and 409/conflict is returned for others.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `export:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---

create-export-connection-run

connectionId

Location

This response indicates that an active run is in progress and link is provided in location header.

This response indicates that user does not have required permissions to run specified connection.

This response indicates that the specified connection not found.

A run request is already being processed.

Invalid request to create a connection run.

---

Delete connection

### Authentication

Requires `Authorization` header with valid Bearer token for scope `export:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.


---


delete-export-connection

This response indicates that the specified connection was not found.

---

Retrieves a ExportConnection with the specified ID.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `export:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---

get-export-connection

This response indicates that user does not have required permissions to get specified connection.

---

Retrieves export connections for the specified iModel.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `export:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---

get-export-connections

imodelId

The [$top](https://www.odata.org/getting-started/basic-tutorial/#topskip) system query option requests the number of items in the queried collection to be included in the result.

$top

The [$skip](https://www.odata.org/getting-started/basic-tutorial/#topskip) query option requests the number of items in the queried collection that are to be skipped and not included in the result.

$skip

representation

This response indicates that user does not have required permissions to get specified connections.

---

Retrieves a ExportConnection Run with the specified ID.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `export:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---

get-export-connection-run

runId

This response indicates that user does not have required permissions to get specified connection run.

This response indicates that the specified connection run not found.

---

Retrieves all ExportConnection Runs for the specified connection.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `export:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---

get-export-connection-runs

This response indicates that user does not have required permissions to get specified connection runs.

Changelog - Export | iTwin Platform

This tutorial guides you through exporting data from an iModel to other formats, such as IFC or LandXM using the Export API.

Changelog

Jun 17, 2022