Ship24 🚚 Couriers API

openapi: 3.2.0
info:
  title: Ship24 Tracking 🚚 Couriers API
  description: '## Getting started


    Make sure to read the Getting started section of our API Documentation before using the endpoints presented below.'
  version: 1.0.0
  contact:
    name: Ship24
    url: https://www.ship24.com/contact-us
servers:
- url: https://api.ship24.com
tags:
- name: Couriers
paths:
  /public/v1/couriers:
    get:
      tags:
      - Couriers
      summary: Get all couriers
      description: This endpoint will return the list of all couriers supported by Ship24, identified by their `courierCode`.
      parameters:
      - name: Authorization
        in: header
        schema:
          type: string
        example: Bearer your_api_key
        description: Your `api_key` prefixed with `Bearer`.
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      couriers:
                        type: array
                        items:
                          type: object
                          properties:
                            courierCode:
                              type: string
                              example: us-post
                              description: The codified code of this courier in Ship24 system.
                            courierName:
                              type: string
                              example: USPS
                              description: The courier name.
                            website:
                              type:
                              - string
                              - 'null'
                              example: https://www.usps.com
                              description: The courier public website.
                            isPost:
                              type: boolean
                              example: true
                              description: '`true` in case the courier is a postal operator.'
                            countryCode:
                              type:
                              - string
                              - 'null'
                              format: ISO 3166-1 alpha-2
                              example: US
                              description: The main country in which the courier is operating.
                            requiredFields:
                              type:
                              - array
                              - 'null'
                              items:
                                type: string
                                enum:
                                - destinationPostCode
                                - destinationCountryCode
                                - courierAccount
                              example:
                              - destinationCountryCode
                              - destinationPostCode
                              description: Indicate which additional information is required by the courier to get optimal tracking results. See [Additional information](https://docs.ship24.com/couriers#required-fields)
                            isDeprecated:
                              type:
                              - boolean
                              example: false
                              description: '`true` in case the courier is deprecated. See [Deprecated couriers](https://docs.ship24.com/couriers#deprecated-couriers)'
              examples:
                success:
                  value:
                    data:
                      couriers:
                      - courierCode: us-post
                        courierName: USPS
                        website: https://www.usps.com
                        isPost: true
                        countryCode: US
                        requiredFields: null
                        isDeprecated: false
                      - courierCode: fr-post
                        courierName: La Poste
                        website: http://www.laposte.fr/
                        isPost: true
                        countryCode: FR
                        requiredFields:
                        - destinationCountryCode
                        isDeprecated: false
                      - courierCode: palletways
                        courierName: Palletways
                        website: https://www.palletways.com/
                        isPost: false
                        countryCode: GB
                        requiredFields:
                        - destinationPostCode
                        isDeprecated: false
      operationId: get-couriers
components:
  securitySchemes:
    Authorization:
      name: Bearer your_api_key
      type: apiKey
      in: header
      description: 'The Ship24 API uses API keys to authenticate requests. You can [view and manage them in your Dashboard](https://dashboard.ship24.com/integrations/api-keys). A `Default` API key is created after you subscribe to a plan.


        To authenticate your requests, include an `Authorization` HTTP header to all your requests with the following value: `Bearer your_api_key`. (Replace `your_api_key` by the one from your dashboard and don''t forget the `Bearer` prefix.)'