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

โ€‹Schemas


โ€‹Shipment

  • recipientAddressobjectย ยทย required
  • senderAddressobjectย ยทย required
  • packagesobject[]ย ยทย minItems: 1ย ยทย maxItems: 50ย ยทย uniqueย ยทย required
  • idstringย ยทย uuid
    Example: 123e4567-e89b-12d3-a456-426614174000
  • recipientEmailstringย ยทย email
    Example: recipient@example.com
  • statusstring | nullย ยทย enum
    Enum values:
    CREATED
    IN_TRANSIT
    DELIVERED
    EXCEPTION
  • trackingNumberstringย ยทย pattern: ^[A-Z0-9]{10,20}$
  • createdAtstringย ยทย date-time
  • commentsobject[]ย ยทย enumย ยทย maxItems: 100
    Enum values:
    PENDING
    APPROVED
    REJECTED
  • tagsstring[]
    Enum values:
    FRAGILE
    EXPRESS
    INTERNATIONAL
    CUSTOMS_REQUIRED
  • facilitiesstring[]
    Enum values:
    LAX1
    JFK2
    ORD3
    DFW4
    SEA5
  • customDataarray

    Array of custom data items that can be of any type

  • metadataobject

    Empty object for future extensibility

โ€‹Address

  • streetstringย ยทย minLength: 1ย ยทย maxLength: 200ย ยทย required
  • citystringย ยทย minLength: 1ย ยทย maxLength: 100ย ยทย required
  • countrystringย ยทย pattern: ^[A-Z]{2}$ย ยทย required

    ISO 3166-1 alpha-2 country code

  • postalCodestringย ยทย minLength: 1ย ยทย maxLength: 20ย ยทย required
  • statestringย ยทย minLength: 1ย ยทย maxLength: 100

โ€‹Package

  • weightnumberย ยทย floatย ยทย min: 0.1ย ยทย max: 1000ย ยทย required

    Weight in kilograms

  • dimensionsobjectย ยทย required

โ€‹Dimensions

  • lengthnumberย ยทย floatย ยทย min: 1ย ยทย max: 300ย ยทย required

    Length in centimeters

  • widthnumberย ยทย floatย ยทย min: 1ย ยทย max: 300ย ยทย required

    Width in centimeters

  • heightnumberย ยทย floatย ยทย min: 1ย ยทย max: 300ย ยทย required

    Height in centimeters

โ€‹Error

  • codestringย ยทย minLength: 1ย ยทย maxLength: 50ย ยทย pattern: ^[A-Z_]+$ย ยทย required
  • messagestringย ยทย minLength: 1ย ยทย maxLength: 500ย ยทย required

โ€‹ShipmentHistory

  • currentShipmentobject
  • previousShipmentcircular
  • transferredAtstringย ยทย date-time

    When the shipment was transferred

โ€‹Comment

  • idstringย ยทย pattern: ^[a-zA-Z0-9-]+$ย ยทย required

    Unique identifier for the comment

  • authorstringย ยทย required

    Name of the person who wrote the comment

  • textstringย ยทย required

    Content of the comment

  • timestampstringย ยทย date-timeย ยทย required

    When the comment was posted

  • repliesarrayย ยทย circular

    Nested replies to this comment

โ€‹Organization

  • idstringย ยทย pattern: ^[a-zA-Z0-9-]+$ย ยทย required

    Unique identifier for the organization

  • namestringย ยทย minLength: 1ย ยทย maxLength: 200ย ยทย required

    Name of the organization

  • parentcircular
  • subarrayย ยทย maxItems: 100ย ยทย circular

    Child organizations (array circular reference)

โ€‹LinkedShipment

  • idstringย ยทย uuidย ยทย required

    Unique identifier for the shipment

  • statusstringย ยทย enumย ยทย required
    Enum values:
    PENDING
    IN_TRANSIT
    DELIVERED
  • nextcircular
  • previouscircular