We're announcing 🧑‍🚀 inter-galactic shipping ✨ for 3025!
Cosmo Cargo Inc.
Interplanetary Shipping API

Interplanetary

Endpoint

Create a shipment

POST
https://api.sh.example.com/v1
/interplanetary/shipments

Creates a new interplanetary shipment with the provided details

Create a shipment › Request Body

  • originPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • destinationPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • cargoobject · required
  • shippingClassstring · enum · required

    Shipping speed class

    Enum values:
    STANDARD
    EXPRESS
    PRIORITY
  • idstring · uuid · readOnly
  • radiationShieldingboolean

    Whether cargo needs radiation shielding

    Default: true
  • statusstring · enum · readOnly
    Enum values:
    SCHEDULED
    LAUNCHED
    IN_TRANSIT
    APPROACHING
    LANDED
    DELIVERED
  • estimatedDeliverystring · date-time · readOnly
  • trackingNumberstring · readOnly
  • createdAtstring · date-time · readOnly

Create a shipment › Responses

Shipment created successfully

  • originPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • destinationPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • cargoobject · required
  • shippingClassstring · enum · required

    Shipping speed class

    Enum values:
    STANDARD
    EXPRESS
    PRIORITY
  • idstring · uuid · readOnly
  • radiationShieldingboolean

    Whether cargo needs radiation shielding

    Default: true
  • statusstring · enum · readOnly
    Enum values:
    SCHEDULED
    LAUNCHED
    IN_TRANSIT
    APPROACHING
    LANDED
    DELIVERED
  • estimatedDeliverystring · date-time · readOnly
  • trackingNumberstring · readOnly
  • createdAtstring · date-time · readOnly

Track shipment

GET
https://api.sh.example.com/v1
/interplanetary/shipments/{trackingNumber}

Get the current status and tracking information for an interplanetary shipment

Track shipment › path Parameters

  • trackingNumberstring · required

Track shipment › Responses

Shipment tracking information retrieved successfully

  • originPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • destinationPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • cargoobject · required
  • shippingClassstring · enum · required

    Shipping speed class

    Enum values:
    STANDARD
    EXPRESS
    PRIORITY
  • idstring · uuid · readOnly
  • radiationShieldingboolean

    Whether cargo needs radiation shielding

    Default: true
  • statusstring · enum · readOnly
    Enum values:
    SCHEDULED
    LAUNCHED
    IN_TRANSIT
    APPROACHING
    LANDED
    DELIVERED
  • estimatedDeliverystring · date-time · readOnly
  • trackingNumberstring · readOnly
  • createdAtstring · date-time · readOnly

Create specialized shipment

POST
https://api.sh.example.com/v1
/interplanetary/specialized-shipments

Creates a new interplanetary shipment for specialized cargo types like cryo, quantum, or antimatter

Create specialized shipment › Request Body

  • originPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • destinationPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • cargoobject · required
  • shippingClassstring · enum · required

    Shipping speed class

    Enum values:
    STANDARD
    EXPRESS
    PRIORITY
  • idstring · uuid · readOnly
  • radiationShieldingboolean

    Whether cargo needs radiation shielding

    Default: true
  • statusstring · enum · readOnly
    Enum values:
    SCHEDULED
    LAUNCHED
    IN_TRANSIT
    APPROACHING
    LANDED
    DELIVERED
  • estimatedDeliverystring · date-time · readOnly
  • trackingNumberstring · readOnly
  • createdAtstring · date-time · readOnly

Create specialized shipment › Responses

Specialized shipment created successfully

  • originPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • destinationPlanetstring · enum · required
    Enum values:
    Earth
    Mars
    Venus
    Mercury
    Jupiter
  • cargoobject · required
  • shippingClassstring · enum · required

    Shipping speed class

    Enum values:
    STANDARD
    EXPRESS
    PRIORITY
  • idstring · uuid · readOnly
  • radiationShieldingboolean

    Whether cargo needs radiation shielding

    Default: true
  • statusstring · enum · readOnly
    Enum values:
    SCHEDULED
    LAUNCHED
    IN_TRANSIT
    APPROACHING
    LANDED
    DELIVERED
  • estimatedDeliverystring · date-time · readOnly
  • trackingNumberstring · readOnly
  • createdAtstring · date-time · readOnly

Plan shipping route

POST
https://api.sh.example.com/v1
/interplanetary/route-planning

Plans a shipping route with either direct or multi-hop configuration

Plan shipping route › Request Body

  • routeTypestring · enum · required
    Enum values:
    DIRECT
    MULTI_HOP
  • routerequired
  • requirementsarray

Plan shipping route › Responses

Route planned successfully

  • routeTypestring · enum · required
    Enum values:
    DIRECT
    MULTI_HOP
  • routerequired
  • requirementsarray