Developer documentation
Integrate customs-invoice.com
Send shipment JSON, get back compliant PDF URLs. Designed for embedding into Shopify apps, freight-forwarder dashboards, ShipStation / Shippo workflows, or bespoke internal tooling.
Quickstart
Ship your first invoice through the API in five minutes — key, request, PDF.
Read
API reference
Endpoints, request / response schemas, code samples in curl / Node / Python.
Read
Error reference
Every error code the API can return and how to recover from it.
Read
Changelog
Additive-first API evolution. No breaking changes without a version bump.
Read
Core concepts
- Invoices — a single call creates one shipment record and renders 1–4 PDFs (commercial or proforma, plus optional packing list and certificate of origin).
- Signed URLs — responses contain one-hour signed URLs per document. Persist the PDFs on your side rather than relying on long-lived links.
- Bearer auth — every key is 48 hex characters with a
cik_prefix. Keys are stored as SHA-256 digests; we can't recover a lost key. - Rate limits — 60 invoices per hour per key. Heavier throughput available by request.