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, 10:01:18 AM. See more in the build configuration guide.

This API allows you to create shipping labels and stamps for your shipments.

Authentication

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

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

This API allows you to register webhooks to receive real-time updates about your shipments.

Authentication

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

Webhook Events

The following events are available for subscription:

• shipment.created
• shipment.in_transit
• shipment.delivered
• shipment.exception

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

This API enables interplanetary shipping capabilities through the Cosmo Cargo platform.

Authentication

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

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

Track shipments and get status updates using tracking numbers.

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

Advanced AI-powered endpoints for intelligent cargo management, route optimization, and predictive analytics for the Cosmo Cargo platform.

Model Context Protocol (MCP) Integration

This API includes MCP-enabled endpoints that allow AI tools to directly interact with our cargo management system for intelligent decision-making and automation.

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

Advanced cargo container booking and management for interplanetary shipping. This API demonstrates complex schema composition using allOf, anyOf, and oneOf patterns for maximum flexibility in container configuration.

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