We're announcing 🧑‍🚀 inter-galactic shipping ✨ for 3025!
Overview

​Shipment API

This API allows you to create and track shipments through the Cosmo Cargo platform.

Authentication

All endpoints require a valid API key passed in the X-API-Key header.

Endpoint

​List all organizations

GET
https://api.sh.example.com/v1
/organizations

Returns a list of all organizations in the hierarchy

​Responses

    • id
      string

      Unique identifier for the organization

    • name
      string

      Name of the organization

    • parent
      object
      optional
      circular
    • sub
      array
      optional
      circular

      Child organizations (array circular reference)

​Create a new organization

POST
https://api.sh.example.com/v1
/organizations

Creates a new organization, optionally as part of an existing hierarchy

​Request Body

  • id
    string

    Unique identifier for the organization

  • name
    string

    Name of the organization

  • parent
    object
    optional
    circular
  • sub
    array
    optional
    circular

    Child organizations (array circular reference)

​Responses

    • id
      string

      Unique identifier for the organization

    • name
      string

      Name of the organization

    • parent
      object
      optional
      circular
    • sub
      array
      optional
      circular

      Child organizations (array circular reference)