Panvaya Tracking API

All endpoints are served under a single base URL and return JSON. Every request must include your API key in the X-API-Key header. There are two environments, selected by which key you use: live keys return real tracking data and consume your quota; sandbox keys return deterministic mock data for free.

https://api.panvaya.com/api/v1

Create a key from your dashboard under API & Integration. The full key is shown once at creation, so store it securely. Pass it on every request:

X-API-Key: pv_live_your_key_here

Live keys are prefixed pv_live_ and sandbox keys pv_test_. You may also send the key as Authorization: Bearer <key>.

API usage is metered against your organization's monthly allotment. You are charged one call per successful live lookup that returns tracking data. Lookups that return 404 NOT_FOUND are never billed, and sandbox calls are always free. Track your consumption on the Integration page. When the allotment is spent, requests return 402 QUOTA_EXCEEDED until the window resets or the limit is raised.

Look up an ocean container by its ISO 6346 number.

curl -X POST https://api.panvaya.com/api/v1/track/ocean \
  -H "X-API-Key: pv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"containerNumber": "MSCU1234567"}'

Example response

{
  "status": "IN_TRANSIT",
  "shipmentType": "OCEAN",
  "carrierCode": "MSCU",
  "carrierName": "Panvaya",
  "containerNo": "MSCU1234567",
  "eta": "2026-07-21T09:00:00",
  "ata": null,
  "milestones": [
    {
      "event": "Loaded on vessel",
      "location": "Rotterdam, NL",
      "timestamp": "2026-07-02T14:20:00"
    },
    {
      "event": "Vessel departed",
      "location": "Rotterdam, NL",
      "timestamp": "2026-07-02T22:10:00"
    }
  ]
}

Look up an air shipment by its air waybill (AWB) number.

curl -X POST https://api.panvaya.com/api/v1/track/air \
  -H "X-API-Key: pv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"awbNumber": "020-12345675"}'

Example response

{
  "status": "IN_TRANSIT",
  "shipmentType": "AIR",
  "airlineName": "Panvaya",
  "flightNumber": "PV123",
  "originAirport": "FRA",
  "destinationAirport": "JFK",
  "eta": "2026-07-08T18:30:00",
  "milestones": [
    { "event": "Received", "location": "FRA", "timestamp": "2026-07-07T09:00:00" },
    { "event": "Departed", "location": "FRA", "timestamp": "2026-07-07T13:45:00" }
  ]
}

Returns supported carriers and their Panvaya ids, for the optional carrierId parameter. Pass mode=ocean or mode=air.

curl "https://api.panvaya.com/api/v1/carriers?mode=ocean" \
  -H "X-API-Key: pv_live_your_key_here"

Errors use a consistent envelope with a stable, machine-readable code. Branch on the code, not the message text.

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "containerNumber is required."
  }
}

Create a sandbox key (prefixed pv_test_) to build and test your integration without spending quota. Sandbox requests hit the same endpoints and return the same response shape, populated with deterministic mock data. Switch to a live key when you are ready for real tracking.