# Exporting an API definition

Use the GET method on the /api-definitions/{id} endpoint to export an API definition from Talend Cloud API Designer.

For use cases using this request, see [Talend Cloud API Designer Examples](https://help.qlik.com/talend/en-US/api-designer-user-guide/Cloud/api-designer-examples).

## Before you begin

* You have an API in Talend Cloud API Designer.
* You have generated a Personal Access Token. For further information, see [Generating a Personal Access Token](https://help.qlik.com/talend/r/en-US/Cloud/management-console-user-guide/cloud-access-token).

## Procedure

1. Open Talend Cloud API Tester and create a new request.
2. Keep the default GET method and enter the following URI with the correct parameters:

   https://apid.{region}.cloud.talend.com/api/v1/api-definitions/{api-id}
   | Parameter | Description |
   | --- | --- |
   | {region} | Region for your Talend Cloud account. The value can be:<br><br><ul> <li> <span>us-west</span> </li> <li> <span>us</span> </li> <li> <span>eu</span> </li> <li> <span>ap</span> </li> <li> <span>au</span> </li> </ul><br><br>For more information, see [Accessing Talend Cloud applications](https://help.qlik.com/talend/en-US/installation-guide-windows/Cloud/talend-cloud-application-url). |
   | {api-id} | ID of<br>the API version to fetch. To get it, open your API in Talend Cloud API Designer and go to Settings &gt; MANAGEMENT API or use the GET method on the /api-definitions endpoint to get a list<br>of API definitions with their IDs. |
3. Optional: Expand QUERY PARAMETERS and click Add query parameters.

   The following parameters are available:
   | Parameter | Description |
   | --- | --- |
   | format | Format in which you want to export your<br>definition. The value can be:<br><br><ul> <li> <kbd>OpenApi3</kbd> (default value)</li> <li> <kbd>Swagger20</kbd> </li> <li> <kbd>Swagger12</kbd> </li> <li> <kbd>Raml10</kbd> </li> <li> <kbd>Raml08</kbd> </li> <li> <kbd>OpenApi3Aws</kbd> (format compatible with AWS                                            API Gateway)</li> <li> <kbd>Swagger20Azure</kbd> (format compatible with                                            Azure API Management)</li> </ul> |
   | talendExtensions | Specify if you want your exported<br>definition to contain Talend extensions or annotations. The value can<br>be true or false. The default value is<br>false.<br><br>Information noteNote:<br>Talend<br>extensions are not compatible with AWS API Gateway and Azure<br>API Management. If you have entered OpenApi3AWS or Swagger20Azure in the<br>format parameter,<br>this parameter is ignored. |
4. Click the Add header button and enter Authorization in the name field and Bearer followed by a space and your token in the value field.

   Information noteTip: In Talend Cloud API Tester, you can add your token as a private environment variable and reference it in your requests using the expression builder. For more information, see [Using environments](https://help.qlik.com/talend/r/en-US/Cloud/api-tester-user-guide/using-environments).
5. Once your request is configured, click Send.
   ### Example

   ![In Talend Cloud API Tester, the request is configured.](https://help.qlik.com/talend/en-US/api-user-guide/Resources/images/export_api_definition_1_configured_request.png)

## Results

Talend Cloud API Tester returns a response containing the API definition in the selected format. You can click the Download button at the bottom of the page to save it. ![The Download button at the bottom right of the page.](https://help.qlik.com/talend/en-US/api-user-guide/Resources/images/export_response.png)