Shipment API

Download schema

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

Plan	Requests/min	Burst
Free	60	10
Pro	600	50
Enterprise	Custom	Custom

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 9/24/2026, 1:36:25 PM. See more in the build configuration guide.

Tags

Shipment Management

Endpoints for creating, tracking, updating, and managing shipments.

Notifications

Endpoints for tracking shipments and configuring notifications for shipment status updates.

Rates & Billing

International Shipping

Operations for managing customs documentation, duties, and international shipment processes.

Sector 7G Advisory

Interstellar customs regulations were updated in Stardate 2025.3. All shipments crossing the Outer Rim must include a Quantum Manifest.

Documentation