Shipment API

The Shipment API provides programmatic access to Cosmo Cargo's interstellar logistics network. Create shipments, calculate rates, track packages in real-time, and manage customs documentation for cross-border deliveries.

Getting Started

To start shipping, create a shipment with origin and destination addresses, then calculate rates for your preferred service level. Once confirmed, use the tracking endpoints to monitor delivery progress.

Code
curl -X POST https://api.cosmocargo.com/v1/shipments \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"recipientAddress": {...}, "senderAddress": {...}, "packages": [...]}'

Rate Limits

Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response.

Idempotency

POST and PUT endpoints support idempotency keys via the Idempotency-Key header. Sending the same key within 24 hours returns the original response without creating duplicates.

Versioning

The API is versioned via the X-API-Version header. The current stable version is 2024-01. Omitting the header defaults to the latest stable version.

This schema was processed by a build processor at 3/9/2026, 9:39:02 AM. See more in the build configuration guide.