Build on the WorldBridges API

A REST API for rating, booking, and tracking cross-border shipments — the same one that powers this website. JSON in, JSON out, one API key.

Open the interactive API docs

Authentication

Every request outside the public rates/tracking demo endpoints requires an API key. Generate one from your dashboard's API keys page, then send it as a bearer token:

# Every key looks like wb_live_ followed by 32 hex characters
Authorization: Bearer wb_live_3f9c1a7b2e6d4f8091c5a3b7d2e6f401

Get a rate quote

A stateless quote across origin country, destination country, weight, and service code — no shipment is created.

curl -X POST https://api.worldbridges.org/v1/rates \
  -H "Authorization: Bearer wb_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "origin_country": "US",
    "dest_country": "CA",
    "weight_lb": 6.0,
    "service": "cross_border"
  }'

Track a shipment

Returns the same status and event timeline shown on the public tracking page — whether the number belongs to a real shipment or is being looked up for the first time.

curl https://api.worldbridges.org/v1/tracking/WB482913770045 \
  -H "Authorization: Bearer wb_live_..."

Endpoints

Method & path	Description
`POST /v1/rates`	Stateless rate quote for a service, weight, and country pair.
`GET /v1/tracking/{number}`	Current status and event timeline for a tracking number.
`POST /v1/shipments`	Book a shipment and generate a label & tracking number.
`GET /v1/shipments`	List shipments on your account.
`GET /v1/shipments/{id}`	Retrieve a single shipment.
`GET /v1/addresses`, `POST /v1/addresses`	Manage reusable origin/destination addresses.

Full request/response schemas, error codes, and a try-it-now console are in the interactive docs.

Open /docs