We're announcing ๐Ÿง‘โ€๐Ÿš€ inter-galactic shipping โœจ for 3025!
Shipment API

โ€‹Documentation

Endpoints for generating and retrieving shipment-related documents.


Endpoint

โ€‹Get shipping label

GET
https://api.sh.example.com/v1
/shipments/{shipmentId}/label

Get the shipping label for a shipment in various formats. Supports both JSON and XML responses. XML format follows the EDIFACT D96A standard for shipping label interchange, while JSON is provided for modern API integrations.

โ€‹Get shipping label โ€บ path Parameters

  • shipmentIdstringย ยทย uuidย ยทย required

โ€‹Get shipping label โ€บ query Parameters

  • formatstringย ยทย enum

    Label format

    Enum values:
    PDF
    PNG
    ZPL

โ€‹Get shipping label โ€บ Headers

  • Acceptstringย ยทย enum

    Response format. Use application/xml for EDI-compliant responses following EDIFACT D96A standard.

    Enum values:
    application/json
    application/xml

โ€‹Get shipping label โ€บ Responses

    • shipmentIdstringย ยทย uuidย ยทย required
    • formatstringย ยทย enumย ยทย required
      Enum values:
      PDF
      PNG
      ZPL
    • idstringย ยทย uuidย ยทย readOnly
    • urlstringย ยทย uriย ยทย readOnly
    • createdAtstringย ยทย date-timeย ยทย readOnly
    • expiresAtstringย ยทย date-timeย ยทย readOnly

โ€‹Get commercial invoice

GET
https://api.sh.example.com/v1
/shipments/{shipmentId}/documents/v2/commercial-invoice

Generate an enhanced commercial invoice with digital signatures, multiple format support, and customs pre-clearance capabilities. Supports both standard formats and country-specific templates.

โ€‹Get commercial invoice โ€บ path Parameters

  • shipmentIdstringย ยทย uuidย ยทย required

โ€‹Get commercial invoice โ€บ query Parameters

  • formatstringย ยทย enum

    Document format. XML/EDI formats follow international customs standards.

    Enum values:
    PDF
    DOCX
    XML
    JSON
    EDI
  • templatestringย ยทย enum

    Country-specific template to use

    Enum values:
    STANDARD
    EU
    US
    CN
    UK
  • includestring[]

    Additional documents to include

    Enum values:
    digital_signature
    customs_preclearance
    packing_list
    certificate_origin

โ€‹Get commercial invoice โ€บ Responses

    • documentsobject[]
    • customsStatusstringย ยทย enum
      Enum values:
      PENDING
      PRE_CLEARED
      CLEARED
deprecated

โ€‹Get commercial invoice (legacy)

GET
https://api.sh.example.com/v1
/shipments/{shipmentId}/documents/commercial-invoice

Generate a basic commercial invoice for an international shipment. This endpoint is deprecated, please use /shipments/{shipmentId}/documents/v2/commercial-invoice for enhanced features including digital signatures, multiple formats, and customs pre-clearance.

โ€‹Get commercial invoice (legacy) โ€บ path Parameters

  • shipmentIdstringย ยทย uuidย ยทย required

โ€‹Get commercial invoice (legacy) โ€บ query Parameters

  • formatstringย ยทย enum
    Enum values:
    PDF
    DOCX

โ€‹Get commercial invoice (legacy) โ€บ Responses

    • urlstringย ยทย uri
    • expiresAtstringย ยทย date-time