We're announcing 🧑‍🚀 inter-galactic shipping ✨ for 3025!
Cosmo Cargo Inc.
Cargo Container Specifications API
Cargo Container Specifications API

Schemas

Download schema

BaseContainer

Base properties shared by all container types
​object · required

Container dimensions in parsec-millimeters

maxWeight
​number · min: 1 · max: 100000 · required

Maximum weight capacity in gravitic units

shieldRating
​string · enum

Protective shield classification

Enum values:
basic
reinforced
military-grade
quantum-hardened

StandardContainer

Base properties shared by all container types
​object · required

Container dimensions in parsec-millimeters

maxWeight
​number · min: 1 · max: 100000 · required

Maximum weight capacity in gravitic units

type
​string · const · required
Const value: standard
stackable
​boolean · required

Whether container can be stacked in zero-G

shieldRating
​string · enum

Protective shield classification

Enum values:
basic
reinforced
military-grade
quantum-hardened
standardFeatures
​string[]
Enum values:
anti-gravity-hooks
solar-panels
auto-pressurization

RefrigeratedContainer

Base properties shared by all container types
​object · required

Container dimensions in parsec-millimeters

maxWeight
​number · min: 1 · max: 100000 · required

Maximum weight capacity in gravitic units

type
​string · const · required
Const value: refrigerated
​object · required

Temperature range in Kelvin

coolingSystem
​string · enum · required

Type of cooling technology

Enum values:
cryo-cycle
quantum-cooling
dark-matter-refrigeration
shieldRating
​string · enum

Protective shield classification

Enum values:
basic
reinforced
military-grade
quantum-hardened
backupPower
​boolean

Whether backup power is available during warp jumps

PressurizedContainer

Base properties shared by all container types
​object · required

Container dimensions in parsec-millimeters

maxWeight
​number · min: 1 · max: 100000 · required

Maximum weight capacity in gravitic units

type
​string · const · required
Const value: pressurized
pressureLevel
​number · min: 50 · max: 500 · required

Internal pressure in kilopascals

​object · required

Gas mixture percentages

shieldRating
​string · enum

Protective shield classification

Enum values:
basic
reinforced
military-grade
quantum-hardened
leakDetection
​boolean
Default: true

HazmatContainer

Base properties shared by all container types
​object · required

Container dimensions in parsec-millimeters

maxWeight
​number · min: 1 · max: 100000 · required

Maximum weight capacity in gravitic units

type
​string · const · required
Const value: hazmat
hazardClass
​string · enum · required

Classification of hazardous material

Enum values:
explosive
radioactive
bio-hazard
antimatter
temporal-anomaly
containmentLevel
​integer · min: 1 · max: 5 · required

Galactic containment certification level

shieldRating
​string · enum

Protective shield classification

Enum values:
basic
reinforced
military-grade
quantum-hardened
​object
emergencyProtocol
​string

Emergency response procedure code

ContainerType

oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = object · type="standard" · requires: dimensions, maxWeight, stackable
type = object · type="refrigerated" · requires: temperatureRange, coolingSystem, dimensions +1 more
type = object · type="pressurized" · requires: pressureLevel, atmosphereComposition, dimensions +1 more
type = object · type="hazmat" · requires: hazardClass, containmentLevel, dimensions +1 more
Properties for Variant 1:
Base properties shared by all container types
StandardContainer
​object · required

Container dimensions in parsec-millimeters

maxWeight
​number · min: 1 · max: 100000 · required

Maximum weight capacity in gravitic units

type
​string · const · required
Const value: standard
stackable
​boolean · required

Whether container can be stacked in zero-G

shieldRating
​string · enum

Protective shield classification

Enum values:
basic
reinforced
military-grade
quantum-hardened
standardFeatures
​string[]
Enum values:
anti-gravity-hooks
solar-panels
auto-pressurization

HandlingRequirement

anyOf
At least one variant must match. Multiple variants may match simultaneously.

Decision Table

VariantMatching Criteria
type = object · requires: type
type = object · requires: type, maxGForce
type = object · requires: type
type = object · requires: type, maxTransitTime
Properties for Variant 1:
Anti-gravity handling
type
​string · const · required
Const value: anti-gravity
intensity
​string · enum
Enum values:
low
medium
high

PaymentMethod

Shared transaction metadata for any payment method.
amount
​number · min: 0 · required

Total amount to charge, in the given currency.

currencyCode
​string · required

ISO-style currency code, e.g. GCR for Galactic Credits.

Example: GCR
transactionRef
​string

Optional client-side transaction reference for reconciliation.

memo
​string

Free-form memo attached to the payment.

oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = object · type="galactic-credits" · requires: accountNumber
type = object · type="crypto" · requires: currency, walletAddress
type = object · type="trade-agreement" · requires: agreementId
Properties for Variant 1:
Galactic Credits payment
type
​string · const · required
Const value: galactic-credits
accountNumber
​string · pattern: ^GC-[0-9]{12}$ · required
autoDeduct
​boolean
Default: true

DeliverySpeed

oneOf
Exactly one variant must match.

Decision Table

VariantMatching Criteria
type = object · type="standard-orbit" · requires: estimatedDays
type = object · type="express-warp" · requires: warpFactor
type = object · type="instant-teleport" · requires: sourceGate, destinationGate
Properties for Variant 1:
Standard orbital delivery
type
​string · const · required
Const value: standard-orbit
estimatedDays
​integer · min: 7 · max: 90 · required
trackingEnabled
​boolean
Default: true

NotificationChannel

anyOf
At least one variant must match. Multiple variants may match simultaneously.

Decision Table

VariantMatching Criteria
type = object · requires: type, email
type = object · requires: type, phone
type = object · requires: type, webhook
Properties for Variant 1:
type
​string · const · required
Const value: email
email
​string · email · required

InsuranceCoverage

Base insurance coverage
coverageAmount
​number · min: 1000 · required

Total coverage in galactic credits

deductible
​number · min: 0 · required

Deductible amount

policyNumber
​string
​

QuoteRequest

​ContainerType · required
​object · required
​DeliverySpeed · required
​HandlingRequirement[]

Multiple handling requirements can be specified

​InsuranceCoverage

Base insurance coverage

BookingRequest

​ContainerType · required
​object · required
​DeliverySpeed · required
​object · required
​PaymentMethod · required

Shared transaction metadata for any payment method.

​HandlingRequirement[]

Multiple handling requirements can be specified

​InsuranceCoverage

Base insurance coverage

notes
​string

Additional booking notes

Quote

quoteId
​string · required
totalCost
​number · required

Total cost in galactic credits

​object · required
validUntil
​string · date-time · required
estimatedDelivery
​string · date-time

Booking

​ContainerType · required
​object · required
​DeliverySpeed · required
​object · required
​PaymentMethod · required

Shared transaction metadata for any payment method.

bookingId
​string · pattern: ^BK-[A-Z0-9]{10}$ · required
status
​string · enum · required
Enum values:
pending
confirmed
in-transit
delivered
cancelled
createdAt
​string · date-time · required
​HandlingRequirement[]

Multiple handling requirements can be specified

​InsuranceCoverage

Base insurance coverage

notes
​string

Additional booking notes

containerId
​string · pattern: ^CNT-[A-Z0-9]{8}$
updatedAt
​string · date-time
trackingUrl
​string · uri

ContainerUpdate

Partial update to container specifications
​HandlingRequirement[]
​NotificationChannel[]
notes
​string

Error

code
​string · required
message
​string · required
details
​object