Welcome to the Cosmo Cargo Developer Platform
Cosmo Cargo’s APIs let shippers, freight forwarders and spaceport operators book, label and track cargo across the galaxy: from a parcel to low orbit to a hazmat container bound for the outer colonies.
Architecture & Base URLs
Section titled “Architecture & Base URLs”The Shipment API runs in three environments:
| Environment | Base URL | Usage |
|---|---|---|
| Development | https://api.dev.sh.example.com/v1 |
Building and debugging your integration |
| Staging | https://api.staging.sh.example.com/v1 |
Integration tests and mock launches |
| Production | https://api.sh.example.com/v1 |
Live shipments, customs filings and billing |
The Cosmo Cargo API Suite
Section titled “The Cosmo Cargo API Suite”The APIs are organized by what you ship and who runs it:
- Shipment API: Create shipments, calculate rates, file customs and track every leg.
- Labels & Stamps API: Print shipping labels and postage, in three API versions.
- Cargo Container Specifications API: Quote and book standard, refrigerated, pressurized and hazmat containers.
- Fleet Operations API: Vessels, warp routes and cargo bays.
- Webhook API: Get notified when shipments are created, delayed or delivered.
The API Catalog lists all of them.
Rate Limiting
Section titled “Rate Limiting”To keep the launch queue moving:
- Development and staging: 100 requests per minute per IP.
- Production: 1,000 requests per minute per API key.
When you exceed these limits, requests return an HTTP 429 Too Many Requests response with a Retry-After header giving the wait in seconds.