> ## Documentation Index > Fetch the complete documentation index at: https://sendcloud.dev/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve custom status mapping for an integration > Fetch a map of available shop order statuses and Sendcloud's internal status category for the integration. Only the Prestashop V2 integration is supported. ## OpenAPI ````yaml /.openapi/v3/integrations/openapi.yaml get /shop-order-statuses/mapping openapi: 3.1.0 info: title: Integrations version: 3.0.0 contact: name: Sendcloud API Support email: contact@sendcloud.com license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html description: >- The Integrations API lets you manage some aspects of your integrations, and set and retrieve available shop order statuses. servers: - url: https://panel.sendcloud.sc/api/v3 description: Sendcloud Production security: [] tags: - name: Integrations description: IntegrationsAPI - name: Exception logs description: Integration exception logs API paths: /shop-order-statuses/mapping: get: tags: - Integrations summary: Retrieve custom status mapping for an integration description: > Fetch a map of available shop order statuses and Sendcloud's internal status category for the integration. operationId: sc-public-v3-integrations-get-shop_order_statuses_mapping parameters: - $ref: '#/components/parameters/required_integration_id' responses: '200': description: Custom status mapping for an integration. content: application/json: schema: $ref: '#/components/schemas/get-custom-status-mapping' type: object examples: Response: value: data: integration_id: 23452345 mapping: - status_category: READY_TO_SEND external_id: '11' is_valid: true - status_category: IN_TRANSIT external_id: '11' is_valid: true - status_category: DELIVERED external_id: null is_valid: true - status_category: CANCEL external_id: '1' is_valid: false '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/errors' examples: InvalidRequest: value: errors: - status: '400' code: non_field_errors title: integration ID detail: Integration ID is a required GET parameter security: - HTTPBasicAuth: [] - OAuth2ClientCreds: [] components: parameters: required_integration_id: in: query required: true name: integration_id schema: type: integer example: 251 description: Filter response on `integration_id`. schemas: get-custom-status-mapping: title: Get Custom Status Mapping type: object description: >- Retrieve available shop order statuses mapped onto Sendcloud's internal status category for the given integration. properties: data: type: object properties: integration_id: type: integer description: Sendcloud Integration ID. example: 23452345 mapping: type: array description: >- Array containing available shop order statuses mapped onto Sendcloud's internal status category. - The array contains an object of each of Sendcloud's internal status categories. - Each of sendcloud's internal status categories will be mapped onto either `AvailableStatus.external_id` or `null` - Not all `external_ids` in AvailableStatus may be mapped onto Sendcloud's internal status category. - Two `external_ids` may map onto the same internal status category. - An invalid mapping is a mapping that points to `external_id` that has been deleted. items: type: object description: Status category to `external_id` association map. properties: status_category: type: string enum: - READY_TO_SEND - IN_TRANSIT - DELIVERED - CANCEL description: Sendcloud internal status category. example: READY_TO_SEND external_id: type: - string - 'null' description: >- Field containing the ID linked to the order status inside the integrated webshop. It may be `None` or `null`. example: '11' is_valid: type: boolean description: >- A flag showing if the mapping points to an existing `external_id`. example: true errors: title: Errors type: object description: A standardized format for errors in JSON:API responses. properties: errors: type: - array - object items: type: object allOf: - $ref: '#/components/schemas/ErrorObject' required: - status - code - detail ErrorObject: title: Error type: object description: Error in a JSON:API error format properties: id: type: string description: A unique identifier for the error. links: type: object description: >- A set of hyperlinks that provide additional information about the error. properties: about: type: string description: A URL that provides additional information about the error. status: type: string format: int32 description: The HTTP status code of the error. minLength: 1 code: type: string description: A unique error code for the error, in snake case format. minLength: 1 enum: - unknown_field - invalid - forbidden - invalid_choice - min_value - 'null' - not_found - required - not_a_list - non_field_errors - authentication_failed - validation_error - parcel_announcement_error title: type: string description: A short, human-readable summary of the error. minLength: 1 detail: type: string description: A human-readable explanation of the error. minLength: 1 source: type: object description: >- An object that identifies the source of the error within the request payload. properties: pointer: type: string description: >- A `JSON` pointer to the location of the error within the request payload. parameter: type: string description: The name of the `query` parameter that caused the error. header: type: string description: The name of the `header` parameter that caused the error. meta: type: object description: Additional metadata about the error. securitySchemes: HTTPBasicAuth: type: http description: >- Basic Authentication using API key and secrets is currently the main authentication mechanism. scheme: basic OAuth2ClientCreds: type: oauth2 description: >- OAuth2 is a standardized protocol for authorization that allows users to share their private resources stored on one site with another site without having to provide their credentials. OAuth2 Client Credentials Grant workflow. This workflow is typically used for server-to-server interactions that require authorization to access specific resources. flows: clientCredentials: tokenUrl: https://account.sendcloud.com/oauth2/token/ scopes: api: Default OAuth scope required to access Sendcloud API. ````