DHL

DHL Token API

The Token API from DHL — 2 operation(s) for token.

GitHub OpenAPI

Operations 2

POST /auth/v1/token To generate an access token #
GET /token This endpoint returns the access token and the token expire information in… #

Documentation

📖
Documentation
https://developer.dhl.com/tracking
📖
Documentation
https://developer.dhl.com/api-reference/shipment-tracking-unified-push
📖
Documentation
https://developer.dhl.com/api-reference/additional-services-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/authentication-dhl-ecommerce-americas
📖
Documentation
https://developer.dhl.com/api-reference/authentication-api-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/authentication-api-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/datafactory-autocomplete-20-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-hybrid-mail-shipments-e-post-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-international-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-internetmarke-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-print-mailing-dispatch-preparation-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/deutsche-post-print-mailing-targeting-post-parcel-germany
📖
Documentation
https://developer.dhl.com/parcel-connect
📖
Documentation
https://developer.dhl.com/api-reference/econnect-beta-dhl-ecommerce-europe
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-pickup-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-postnumber-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-private-shipping-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-returns-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/parcel-de-shipping-post-parcel-germany-v2
📖
Documentation
https://developer.dhl.com/api-reference/dhl-parcel-de-shipment-tracking-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dgf-document
📖
Documentation
https://developer.dhl.com/api-reference/duty-tax-dhl-ecommerce-americas
📖
Documentation
https://developer.dhl.com/api-reference/ecommerce-uk
📖
Documentation
https://developer.dhl.com/api-reference/parcel-eu
📖
Documentation
https://developer.dhl.com/api-reference/pickup-cancellation-dhl-ecommerce-india-blue-dart
📖
Documentation
https://developer.dhl.com/api-reference/price-quote-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/print-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/product-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/product-and-sub-product-pickup-detail-dhl-ecommerce-india-blue-dart
📖
Documentation
https://developer.dhl.com/api-reference/product-finder-dhl-ecommerce-americas
📖
Documentation
https://developer.dhl.com/api-reference/products-api-post-parcel-germany
📖
Documentation
https://developer.dhl.com/api-reference/dgf-push-api
📖
Documentation
https://developer.dhl.com/api-reference/registration-pickup-dhl-ecommerce-india-blue-dart
📖
Documentation
https://developer.dhl.com/api-reference/return-label-dhl-ecommerce-americas
📖
Documentation
https://developer.dhl.com/api-reference/shipment-booking-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/dgf-shipment-booking
📖
Documentation
https://developer.dhl.com/api-reference/shipment-label-dhl-global-forwarding
📖
Documentation
https://developer.dhl.com/api-reference/dgf-shipment-status
📖
Documentation
https://developer.dhl.com/api-reference/shipment-tracking-dhl-ecommerce-india-blue-dart
📖
Documentation
https://developer.dhl.com/api-reference/shipment-tracking-v2-dhl-global-forwarding
📖
Documentation
https://developer.dhl.com/api-reference/time-table-dhl-freight
📖
Documentation
https://developer.dhl.com/api-reference/tracking-dhl-ecommerce-americas

Specifications

Schemas & Data

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/dhl:dhl-token-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dhl-token-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Dhl Token API
  version: '1.0'
  description: 'Operations tagged Token across 3 of this provider''s published API definitions: dhl-authentication-api-dhl-freight-openapi.yml, dhl-authentication-api-dhl-freight-openapi.yml, dhl-datafactory-autocomplete-20-post-parcel-germany-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api-sandbox.dhl.com
  description: Please consult the documentation of the API you will access with the token generated by this Authentication API, the server should be the same.
- description: Generated server url
  url: https://autocomplete2.postdirekt.de/autocomplete2
tags:
- name: Token
  externalDocs:
    url: https://developer.dhl.com/api-reference/dhl-authentication-api#get-started-section/
    description: You can find more information in developer.dhl.com
paths:
  /auth/v1/token:
    post:
      tags:
      - Token
      summary: To generate an access token
      parameters:
      - name: response_type
        in: query
        required: true
        schema:
          type: string
          enum:
          - access_token
          - id_token
          example: access_token
          description: 'With with access_token an Opaque token will be generated. With id_token a JSON Web Token (JWT) will be generated. '
      - name: grant_type
        in: query
        required: true
        schema:
          type: string
          enum:
          - client_credentials
          example: client_credentials
          description: 'For now, we only support the Client Credentials grant type of the OAuth framework. '
      responses:
        '200':
          description: The response is successfully return.
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/Success-200-Opaque'
                - $ref: '#/components/schemas/Success-200-JWT'
            text/plain:
              schema:
                type: string
                example: jiONPuG6GYeF....XXXXXXXXXXX
        '400':
          description: Invalid response type or invalid grant type.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error-400'
        '401':
          description: Access to the resource is not allowed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error-401'
      security:
      - basicAuth: []
      operationId: postAuthV1Token
      x-operation-id-source: derived
    servers:
    - url: https://api-sandbox.dhl.com
      description: Please consult the documentation of the API you will access with the token generated by this Authentication API, the server should be the same.
  /token:
    get:
      description: Returns the access token and the token expire information in epoch seconds for the authenticated and authorized user.
      operationId: getTokenResponse
      responses:
        '200':
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/TokenResponse'
          description: OK
        '401':
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized - Missing or bad authentication.
        '403':
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Forbidden - User is not authorized.
        '404':
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found - Resource not found.
        '406':
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Acceptable - Unsupported content negotiation header (Accept-Header) set. Only JSON is allowed.
        '500':
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal Server Error - An internal server error occured.
        '503':
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Service Unavailable - The service is unavailable.
      security:
      - basicAuth: []
      summary: This endpoint returns the access token and the token expire information in…
      tags:
      - Token
    servers:
    - description: Generated server url
      url: https://autocomplete2.postdirekt.de/autocomplete2
components:
  schemas:
    Error-400:
      type: object
      properties:
        status:
          type: integer
          example: 400
        title:
          type: string
          example: Bad Request
        detail:
          type: string
          example: Invalid response type.
    Error-401:
      type: object
      properties:
        status:
          type: integer
          example: 401
        title:
          type: string
          example: Unauthorized
        detail:
          type: string
          example: Access to the resource is not allowed.
    Success-200-JWT:
      type: object
      properties:
        access_token:
          type: string
          example: jiONPuG6GYeF....XXXXXXXXXXX
        id_token:
          type: string
          example: eyJraWQiOiJlZGEzZWRmMS1lNjQ3LWUxZDktOGM4NC......XXXXXXXXXXXXXXXXXXXX
        token_type:
          type: string
          example: Bearer
        expires_in:
          type: integer
          example: 119
    Success-200-Opaque:
      type: object
      properties:
        access_token:
          type: string
          example: jiONPuG6GYeF....XXXXXXXXXXX
        token_type:
          type: string
          example: Bearer
        expires_in:
          type: integer
          example: 119
    TokenResponse:
      properties:
        access_token:
          type: string
        expires_in_epoch_seconds:
          format: int64
          type: integer
      type: object
    ErrorResponse:
      properties:
        errorMessage:
          description: The error message.
          example: An error message example.
          type: string
        errorStatus:
          description: The error status code description.
          example: '''Bad Request'''
          type: string
        errorStatusCode:
          description: The HTTP error status code.
          example: 400
          format: int32
          type: integer
      type: object
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-refined-from:
- dhl-authentication-api-dhl-freight-openapi.yml
- dhl-authentication-api-dhl-freight-openapi.yml
- dhl-datafactory-autocomplete-20-post-parcel-germany-openapi.yml