Track parcels through a strict state machine (label-created → picked-up → in-transit → out-for-delivery → delivered). Reads are public; every write needs the header X-API-Key: cargo-key-123 — a different auth style than the Bearer tokens used elsewhere.
The Cargo Tracking API is a shipment state machine — created, picked up, in transit, delivered — where illegal transitions are rejected rather than accepted. It is also the only API in the catalog that authenticates writes with an X-API-Key header instead of a Bearer token, which makes it useful for testing a client that must handle more than one auth scheme.
Base URL: https://funapi.dev/api/cargo/v1 · 9 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.
where is my package
GET /cargo/v1/shipments — List shipments, filter by statusGET /cargo/v1/shipments/{id} — Track one shipmentGET /cargo/v1/shipments/{id}/events — Tracking historyGET /cargo/v1/shipments/{id}/eta — Estimated delivery (deterministic-mode friendly)GET /cargo/v1/rates — Shipping quote by weightwrites, gated by X-API-Key
POST /cargo/v1/shipments — Create a shipping label (X-API-Key)POST /cargo/v1/shipments/{id}/advance — Advance the state machine one step (X-API-Key)POST /cargo/v1/shipments/{id}/attempt-delivery — Attempt delivery — may fail, 3 strikes returns it (X-API-Key)PUT /cargo/v1/shipments/{id}/address — Redirect a parcel (X-API-Key + If-Match)