{ "item": [ { "name": "Tracking", "description": "AWB tracking and the AWB-prefix airline oracle.", "item": [ { "id": "acd68a52-22e6-40f7-8f4a-4f841a0e421f", "name": "Track an air waybill", "request": { "name": "Track an air waybill", "description": { "content": "Resolve an AWB to its current status, route, pieces, weight, ETA and IATA Cargo-IMP milestone events. Any AWB format is accepted (`203-1234 5675`, `20312345675`, `203-12345675`); the 3-digit prefix selects the airline connector. The raw upstream provider body is never returned — provider + freshness metadata is exposed via `data.metadata` instead.", "type": "text/plain" }, "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "awb", "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "f2bdc173-a691-43a0-929b-842bf881e8b2", "name": "Tracking result.", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"awb\": \"\",\n \"airline_prefix\": \"\",\n \"airline_iata\": \"\",\n \"airline_name\": \"\",\n \"status\": \"available\",\n \"events\": [\n {\n \"status_code\": \"FOH\",\n \"event_family\": \"DELIVERY\",\n \"is_actual\": \"\",\n \"datetime\": \"\",\n \"datetimes\": {\n \"estimated\": \"\",\n \"actual\": \"\",\n \"datetime_precision\": null,\n \"is_actual\": \"\"\n },\n \"station\": \"\",\n \"station_name\": \"\",\n \"location\": {\n \"iata_code\": \"\",\n \"icao_code\": \"\",\n \"name\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"country_code\": \"\",\n \"lat\": \"\",\n \"lng\": \"\",\n \"timezone\": \"\"\n },\n \"flight_number\": \"\",\n \"pieces\": \"\",\n \"weight_kg\": \"\",\n \"description\": \"\"\n },\n {\n \"status_code\": \"CCD\",\n \"event_family\": \"ACCEPTANCE\",\n \"is_actual\": \"\",\n \"datetime\": \"\",\n \"datetimes\": {\n \"estimated\": \"\",\n \"actual\": \"\",\n \"datetime_precision\": \"date\",\n \"is_actual\": \"\"\n },\n \"station\": \"\",\n \"station_name\": \"\",\n \"location\": {\n \"iata_code\": \"\",\n \"icao_code\": \"\",\n \"name\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"country_code\": \"\",\n \"lat\": \"\",\n \"lng\": \"\",\n \"timezone\": \"\"\n },\n \"flight_number\": \"\",\n \"pieces\": \"\",\n \"weight_kg\": \"\",\n \"description\": \"\"\n }\n ],\n \"origin\": \"\",\n \"origin_name\": \"\",\n \"origin_location\": {\n \"iata_code\": \"\",\n \"icao_code\": \"\",\n \"name\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"country_code\": \"\",\n \"lat\": \"\",\n \"lng\": \"\",\n \"timezone\": \"\"\n },\n \"destination\": \"\",\n \"destination_name\": \"\",\n \"destination_location\": {\n \"iata_code\": \"\",\n \"icao_code\": \"\",\n \"name\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"country_code\": \"\",\n \"lat\": \"\",\n \"lng\": \"\",\n \"timezone\": \"\"\n },\n \"pieces\": \"\",\n \"weight_kg\": \"\",\n \"flight_number\": \"\",\n \"departure\": {\n \"estimated\": \"\",\n \"actual\": \"\",\n \"datetime_precision\": \"date\",\n \"is_actual\": \"\"\n },\n \"arrival\": {\n \"estimated\": \"\",\n \"actual\": \"\",\n \"datetime_precision\": null,\n \"is_actual\": \"\"\n },\n \"eta\": \"\",\n \"eta_is_actual\": \"\",\n \"eta_precision\": \"date\",\n \"routes\": [\n {\n \"order_id\": \"\",\n \"status\": \"\",\n \"booking_status\": null,\n \"transport_type\": \"\",\n \"from\": {\n \"iata_code\": \"\",\n \"icao_code\": \"\",\n \"name\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"country_code\": \"\",\n \"lat\": \"\",\n \"lng\": \"\",\n \"timezone\": \"\"\n },\n \"to\": {\n \"iata_code\": \"\",\n \"icao_code\": \"\",\n \"name\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"country_code\": \"\",\n \"lat\": \"\",\n \"lng\": \"\",\n \"timezone\": \"\"\n },\n \"departure\": {\n \"estimated\": \"\",\n \"actual\": \"\",\n \"datetime_precision\": \"datetime\",\n \"is_actual\": \"\"\n },\n \"arrival\": {\n \"estimated\": \"\",\n \"actual\": \"\",\n \"datetime_precision\": null,\n \"is_actual\": \"\"\n },\n \"flight_number\": \"\",\n \"pieces\": \"\",\n \"weight_kg\": \"\",\n \"path\": null\n },\n {\n \"order_id\": \"\",\n \"status\": \"\",\n \"booking_status\": \"cancelled\",\n \"transport_type\": \"\",\n \"from\": {\n \"iata_code\": \"\",\n \"icao_code\": \"\",\n \"name\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"country_code\": \"\",\n \"lat\": \"\",\n \"lng\": \"\",\n \"timezone\": \"\"\n },\n \"to\": {\n \"iata_code\": \"\",\n \"icao_code\": \"\",\n \"name\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": \"\",\n \"country_code\": \"\",\n \"lat\": \"\",\n \"lng\": \"\",\n \"timezone\": \"\"\n },\n \"departure\": {\n \"estimated\": \"\",\n \"actual\": \"\",\n \"datetime_precision\": \"datetime\",\n \"is_actual\": \"\"\n },\n \"arrival\": {\n \"estimated\": \"\",\n \"actual\": \"\",\n \"datetime_precision\": \"date\",\n \"is_actual\": \"\"\n },\n \"flight_number\": \"\",\n \"pieces\": \"\",\n \"weight_kg\": \"\",\n \"path\": null\n }\n ],\n \"metadata\": {\n \"status_code\": \"\",\n \"airline\": {\n \"name\": \"\",\n \"prefix\": \"\",\n \"iata_code\": \"\",\n \"icao_code\": \"\",\n \"url\": \"\"\n },\n \"updated_at\": \"\",\n \"from_cache\": \"\",\n \"cache_expires\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "28938e1e-c681-4ab7-87b1-80a5344ec64e", "name": "Malformed request: bad AWB (`invalid_reference`) or an invalid rate-quote body.", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6ff229c9-6af2-4cb8-a71e-fa434d8616fb", "name": "Missing (`missing_key`), unrecognised (`invalid_key`), revoked (`revoked_key`) or expired (`expired_key`) API key.", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "64f09e69-6c93-4e98-be26-3969deef2db4", "name": "The key's org does not hold an active `aircargo` entitlement (`not_entitled`), or, on the MCP surface (`x-aircargo-surface: mcp`), the org's Navo Tokens wallet cannot pay for this call: `insufficient_balance`, `trial_expired`, `wallet_inactive` or `no_wallet`. A wallet refusal keeps its `code`, `message` and status and adds four fields inside `error`: `credits_required` (the price of this call, or null), `credits_balance` (the wallet balance, null when there is no wallet), `top_up_url` (where to buy more tokens, or null) and `packages` (the token packages on sale).", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da5c6456-91cb-4c79-8160-e5b8f3e6c2c1", "name": "The organisation's access has ended (`access_expired`), the product is switched off for it (`product_not_enabled`), or no AWB limit has been set for it yet (`air_limits_not_set`). Contact support; retrying does not help.", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "346e93bc-772e-44bc-9cfd-01a43752065f", "name": "The AWB prefix resolves to a carrier without a wired connector (`unsupported_carrier`), or the airline returned no record for that AWB (`not_found`). `not_found` carries `retry_after` and a `Retry-After` header: 1 hour for the first two misses in a row, 6 hours from the third, 24 hours from the sixth.", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0e5b1ab-261a-4d78-87c2-1131524392d5", "name": "The `Idempotency-Key` was already used with a different request (`idempotency_key_reused`), or a request with it is still running (`request_in_progress`, retry shortly).", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "30e2694e-6d66-44c5-965c-1bf7cf7e1e98", "name": "Your own usage limit is reached: a key usage window (`rate_limited`), the organisation's AWB limit (`quota_exceeded`) or the free trial's AWB allowance (`free_try_exhausted`). See the `X-Usage-*` response headers.", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "febd623f-f538-499b-8633-59f46a419fd9", "name": "The airline's site failed (`upstream_error`), refused the lookup (`blocked`) or throttled us (`rate_limited`). Temporary; safe to retry.", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Bad Gateway", "code": 502, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a220dadf-099a-45ed-8221-2f181da59128", "name": "Key verification or the entitlement check is temporarily unavailable (`auth_unavailable`), or the API is not accepting requests right now (`auth_unconfigured`). Safe to retry.", "originalRequest": { "url": { "path": [ "track", ":awb" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Air waybill number: 3-digit airline prefix + 8-digit serial (last digit is the modulo-7 check digit). Separators and spaces are ignored.", "type": "text/plain" }, "type": "any", "value": "", "key": "awb" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "050608b9-e619-4781-b962-a1e5ce72afd8", "name": "Resolve an AWB prefix to its airline (free)", "request": { "name": "Resolve an AWB prefix to its airline (free)", "description": { "content": "Free, unauthenticated offline oracle. The 3-digit numeric prefix at the head of every air waybill identifies the issuing airline — the air-cargo equivalent of a container BIC prefix. Returns the airline, its public track-and-trace URL, and which shared platform (if any) fronts it.", "type": "text/plain" }, "url": { "path": [ "prefix", ":code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "code", "disabled": false, "description": { "content": "(Required) 3-digit IATA numeric AWB prefix.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0877ca8a-277d-4b4f-94a3-cdabc81076de", "name": "Airline for the prefix.", "originalRequest": { "url": { "path": [ "prefix", ":code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) 3-digit IATA numeric AWB prefix.", "type": "text/plain" }, "type": "any", "value": "", "key": "code" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"prefix\": \"\",\n \"iata\": \"\",\n \"name\": \"\",\n \"site\": \"\",\n \"platform\": \"ceair\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c31285f4-8012-4052-b0cb-55353e379faa", "name": "Unknown AWB prefix.", "originalRequest": { "url": { "path": [ "prefix", ":code" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) 3-digit IATA numeric AWB prefix.", "type": "text/plain" }, "type": "any", "value": "", "key": "code" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Aircraft", "description": "Live aircraft positions from ADS-B (the air analogue of AIS vessel tracking).", "item": [ { "id": "ae730bd2-6f90-4b70-8cd0-a79cbf79c3e3", "name": "Live position by flight number", "request": { "name": "Live position by flight number", "description": { "content": "Live position(s) for the aircraft operating an IATA flight number (e.g. `EK9812` → callsign `UAE9812`), sourced from ADS-B with OpenSky and FR24 fallback. Airborne-only: a parked or out-of-coverage aircraft is a 404.", "type": "text/plain" }, "url": { "path": [ "aircraft", "flight", ":flightNumber" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "flightNumber", "disabled": false, "description": { "content": "(Required) IATA flight number.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "87c67f71-756b-4739-b8d1-fb0b7d63851d", "name": "One or more live aircraft positions (a flight can map to more than one airframe).", "originalRequest": { "url": { "path": [ "aircraft", "flight", ":flightNumber" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) IATA flight number.", "type": "text/plain" }, "type": "any", "value": "", "key": "flightNumber" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"callsign\": \"\",\n \"registration\": \"\",\n \"icao24_hex\": \"\",\n \"aircraft_type\": \"\",\n \"lat\": \"\",\n \"lon\": \"\",\n \"alt_ft\": \"\",\n \"ground_speed_kt\": \"\",\n \"heading\": \"\",\n \"vertical_rate_fpm\": \"\",\n \"seen_at\": \"\",\n \"origin_iata\": \"\",\n \"dest_iata\": \"\",\n \"operator_iata\": \"\"\n },\n {\n \"callsign\": \"\",\n \"registration\": \"\",\n \"icao24_hex\": \"\",\n \"aircraft_type\": \"\",\n \"lat\": \"\",\n \"lon\": \"\",\n \"alt_ft\": \"\",\n \"ground_speed_kt\": \"\",\n \"heading\": \"\",\n \"vertical_rate_fpm\": \"\",\n \"seen_at\": \"\",\n \"origin_iata\": \"\",\n \"dest_iata\": \"\",\n \"operator_iata\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b1072b4-0243-4a2b-8530-3b0d3fa9d321", "name": "Missing (`missing_key`), unrecognised (`invalid_key`), revoked (`revoked_key`) or expired (`expired_key`) API key.", "originalRequest": { "url": { "path": [ "aircraft", "flight", ":flightNumber" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) IATA flight number.", "type": "text/plain" }, "type": "any", "value": "", "key": "flightNumber" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "86f38f87-5ad5-4816-b851-2984ae4399ed", "name": "The key's org does not hold an active `aircargo` entitlement (`not_entitled`).", "originalRequest": { "url": { "path": [ "aircraft", "flight", ":flightNumber" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) IATA flight number.", "type": "text/plain" }, "type": "any", "value": "", "key": "flightNumber" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6116b722-d8ad-4fb8-b169-f0edee49c850", "name": "No live position — aircraft not airborne or out of ADS-B coverage (`not_found`).", "originalRequest": { "url": { "path": [ "aircraft", "flight", ":flightNumber" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) IATA flight number.", "type": "text/plain" }, "type": "any", "value": "", "key": "flightNumber" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a0d67c4-6809-4558-843a-ea8b1c7501ff", "name": "A usage window (daily / weekly / monthly / lifetime) is exhausted (`rate_limited`), or an upstream airline rate limit was hit. See the `X-Usage-*` response headers.", "originalRequest": { "url": { "path": [ "aircraft", "flight", ":flightNumber" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) IATA flight number.", "type": "text/plain" }, "type": "any", "value": "", "key": "flightNumber" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "15a7136b-dc0b-49ac-bfd2-a96742239e29", "name": "Key verification or the entitlement check is temporarily unavailable (`auth_unavailable`).", "originalRequest": { "url": { "path": [ "aircraft", "flight", ":flightNumber" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) IATA flight number.", "type": "text/plain" }, "type": "any", "value": "", "key": "flightNumber" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "651813b9-d667-4bde-87c2-fa7af0af10a8", "name": "Live position by registration / tail number", "request": { "name": "Live position by registration / tail number", "description": { "content": "Live position(s) for an aircraft by registration (tail number), e.g. `N895FD`. Airborne-only.", "type": "text/plain" }, "url": { "path": [ "aircraft", "reg", ":tail" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "tail", "disabled": false, "description": { "content": "(Required) Aircraft registration / tail number.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "94f7da56-1095-427c-9eef-396eaa28e7dc", "name": "One or more live aircraft positions (a flight can map to more than one airframe).", "originalRequest": { "url": { "path": [ "aircraft", "reg", ":tail" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Aircraft registration / tail number.", "type": "text/plain" }, "type": "any", "value": "", "key": "tail" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"callsign\": \"\",\n \"registration\": \"\",\n \"icao24_hex\": \"\",\n \"aircraft_type\": \"\",\n \"lat\": \"\",\n \"lon\": \"\",\n \"alt_ft\": \"\",\n \"ground_speed_kt\": \"\",\n \"heading\": \"\",\n \"vertical_rate_fpm\": \"\",\n \"seen_at\": \"\",\n \"origin_iata\": \"\",\n \"dest_iata\": \"\",\n \"operator_iata\": \"\"\n },\n {\n \"callsign\": \"\",\n \"registration\": \"\",\n \"icao24_hex\": \"\",\n \"aircraft_type\": \"\",\n \"lat\": \"\",\n \"lon\": \"\",\n \"alt_ft\": \"\",\n \"ground_speed_kt\": \"\",\n \"heading\": \"\",\n \"vertical_rate_fpm\": \"\",\n \"seen_at\": \"\",\n \"origin_iata\": \"\",\n \"dest_iata\": \"\",\n \"operator_iata\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b740678-9662-4aa4-8a0f-47cc5f650349", "name": "Missing (`missing_key`), unrecognised (`invalid_key`), revoked (`revoked_key`) or expired (`expired_key`) API key.", "originalRequest": { "url": { "path": [ "aircraft", "reg", ":tail" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Aircraft registration / tail number.", "type": "text/plain" }, "type": "any", "value": "", "key": "tail" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fcd3f889-1b66-488e-b2f4-a269146a35de", "name": "The key's org does not hold an active `aircargo` entitlement (`not_entitled`).", "originalRequest": { "url": { "path": [ "aircraft", "reg", ":tail" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Aircraft registration / tail number.", "type": "text/plain" }, "type": "any", "value": "", "key": "tail" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a543493-b4b9-47f1-928f-cdf174935ce1", "name": "No live position — aircraft not airborne or out of ADS-B coverage (`not_found`).", "originalRequest": { "url": { "path": [ "aircraft", "reg", ":tail" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Aircraft registration / tail number.", "type": "text/plain" }, "type": "any", "value": "", "key": "tail" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "81c6b543-5d62-452f-8486-74858b22214c", "name": "A usage window (daily / weekly / monthly / lifetime) is exhausted (`rate_limited`), or an upstream airline rate limit was hit. See the `X-Usage-*` response headers.", "originalRequest": { "url": { "path": [ "aircraft", "reg", ":tail" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Aircraft registration / tail number.", "type": "text/plain" }, "type": "any", "value": "", "key": "tail" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "95a58c70-8b95-4661-8b97-6eb1aeff1933", "name": "Key verification or the entitlement check is temporarily unavailable (`auth_unavailable`).", "originalRequest": { "url": { "path": [ "aircraft", "reg", ":tail" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Aircraft registration / tail number.", "type": "text/plain" }, "type": "any", "value": "", "key": "tail" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fb1f259f-1edb-45da-8b3c-3a869cd703aa", "name": "Live position by ATC callsign", "request": { "name": "Live position by ATC callsign", "description": { "content": "Live position(s) for an aircraft by its raw ATC callsign, e.g. `UAE9812`, `FDX9002`. Airborne-only.", "type": "text/plain" }, "url": { "path": [ "aircraft", "callsign", ":cs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "cs", "disabled": false, "description": { "content": "(Required) Raw ATC callsign.", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5edb3b7d-f219-4b52-aef7-8e358ace50c0", "name": "One or more live aircraft positions (a flight can map to more than one airframe).", "originalRequest": { "url": { "path": [ "aircraft", "callsign", ":cs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Raw ATC callsign.", "type": "text/plain" }, "type": "any", "value": "", "key": "cs" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"callsign\": \"\",\n \"registration\": \"\",\n \"icao24_hex\": \"\",\n \"aircraft_type\": \"\",\n \"lat\": \"\",\n \"lon\": \"\",\n \"alt_ft\": \"\",\n \"ground_speed_kt\": \"\",\n \"heading\": \"\",\n \"vertical_rate_fpm\": \"\",\n \"seen_at\": \"\",\n \"origin_iata\": \"\",\n \"dest_iata\": \"\",\n \"operator_iata\": \"\"\n },\n {\n \"callsign\": \"\",\n \"registration\": \"\",\n \"icao24_hex\": \"\",\n \"aircraft_type\": \"\",\n \"lat\": \"\",\n \"lon\": \"\",\n \"alt_ft\": \"\",\n \"ground_speed_kt\": \"\",\n \"heading\": \"\",\n \"vertical_rate_fpm\": \"\",\n \"seen_at\": \"\",\n \"origin_iata\": \"\",\n \"dest_iata\": \"\",\n \"operator_iata\": \"\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c3750e3-66cf-4b4e-948b-4407c5441ef5", "name": "Missing (`missing_key`), unrecognised (`invalid_key`), revoked (`revoked_key`) or expired (`expired_key`) API key.", "originalRequest": { "url": { "path": [ "aircraft", "callsign", ":cs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Raw ATC callsign.", "type": "text/plain" }, "type": "any", "value": "", "key": "cs" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e26c408-70b4-42b0-9313-7e7477fd427b", "name": "The key's org does not hold an active `aircargo` entitlement (`not_entitled`).", "originalRequest": { "url": { "path": [ "aircraft", "callsign", ":cs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Raw ATC callsign.", "type": "text/plain" }, "type": "any", "value": "", "key": "cs" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4901fe6e-dcaf-4cce-a6e2-8be1896a205d", "name": "No live position — aircraft not airborne or out of ADS-B coverage (`not_found`).", "originalRequest": { "url": { "path": [ "aircraft", "callsign", ":cs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Raw ATC callsign.", "type": "text/plain" }, "type": "any", "value": "", "key": "cs" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "574a2dda-ec63-4d12-ba8d-826c2b41ff94", "name": "A usage window (daily / weekly / monthly / lifetime) is exhausted (`rate_limited`), or an upstream airline rate limit was hit. See the `X-Usage-*` response headers.", "originalRequest": { "url": { "path": [ "aircraft", "callsign", ":cs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Raw ATC callsign.", "type": "text/plain" }, "type": "any", "value": "", "key": "cs" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5e1aa4df-ad2f-4c87-a16a-c9a70f7a3bf1", "name": "Key verification or the entitlement check is temporarily unavailable (`auth_unavailable`).", "originalRequest": { "url": { "path": [ "aircraft", "callsign", ":cs" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) Raw ATC callsign.", "type": "text/plain" }, "type": "any", "value": "", "key": "cs" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Rates", "description": "Air-freight rate quotes.", "item": [ { "id": "9e4e303e-e56c-4484-b998-48b5233779fb", "name": "Quote an air-freight lane", "request": { "name": "Quote an air-freight lane", "description": { "content": "Price a lane against the best available rate card. Chargeable weight is `max(gross, volumetric)` where volumetric = `volume_cm3 / 6000`; the applied weight break, net per-kg, surcharges and all-in per-kg are returned. Card source, best-first: live carrier rates (CargoAi) → Freightos FAX region rate → sample card fallback.", "type": "text/plain" }, "url": { "path": [ "rates", "quote" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"origin\": \"\",\n \"destination\": \"\",\n \"weight_kg\": \"\",\n \"volume_cm3\": \"\",\n \"service\": \"general\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": null }, "response": [ { "id": "a4aff782-9a48-43a3-9117-9ddcb5043ffb", "name": "Rate quote.", "originalRequest": { "url": { "path": [ "rates", "quote" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"origin\": \"\",\n \"destination\": \"\",\n \"weight_kg\": \"\",\n \"volume_cm3\": \"\",\n \"service\": \"general\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"origin\": \"\",\n \"destination\": \"\",\n \"chargeable_weight_kg\": \"\",\n \"applied_band\": \"+500\",\n \"net_per_kg\": \"\",\n \"surcharge_per_kg\": \"\",\n \"all_in_per_kg\": \"\",\n \"total_charge\": \"\",\n \"currency\": \"\",\n \"source\": \"\",\n \"airline_iata\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae22fc74-93d7-4bd7-86e8-00b35568a1f7", "name": "Malformed request: bad AWB (`invalid_reference`) or an invalid rate-quote body.", "originalRequest": { "url": { "path": [ "rates", "quote" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"origin\": \"\",\n \"destination\": \"\",\n \"weight_kg\": \"\",\n \"volume_cm3\": \"\",\n \"service\": \"general\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2fd5f173-288a-4086-ac2a-ae731cc1428b", "name": "Missing (`missing_key`), unrecognised (`invalid_key`), revoked (`revoked_key`) or expired (`expired_key`) API key.", "originalRequest": { "url": { "path": [ "rates", "quote" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"origin\": \"\",\n \"destination\": \"\",\n \"weight_kg\": \"\",\n \"volume_cm3\": \"\",\n \"service\": \"general\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19b254d2-6930-4547-9a44-b948dc6cccb6", "name": "The key's org does not hold an active `aircargo` entitlement (`not_entitled`).", "originalRequest": { "url": { "path": [ "rates", "quote" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"origin\": \"\",\n \"destination\": \"\",\n \"weight_kg\": \"\",\n \"volume_cm3\": \"\",\n \"service\": \"general\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Payment Required", "code": 402, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "12187a9a-bc68-4c84-92cc-5c76ae42eb95", "name": "No rate card for the requested lane.", "originalRequest": { "url": { "path": [ "rates", "quote" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"origin\": \"\",\n \"destination\": \"\",\n \"weight_kg\": \"\",\n \"volume_cm3\": \"\",\n \"service\": \"general\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bbf6afea-bfd1-470c-8b7f-098f4d7e21e5", "name": "A usage window (daily / weekly / monthly / lifetime) is exhausted (`rate_limited`), or an upstream airline rate limit was hit. See the `X-Usage-*` response headers.", "originalRequest": { "url": { "path": [ "rates", "quote" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"origin\": \"\",\n \"destination\": \"\",\n \"weight_kg\": \"\",\n \"volume_cm3\": \"\",\n \"service\": \"general\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fd9e6c52-f2ad-4c6c-81f5-bb1f8201d572", "name": "The upstream airline/rate source errored, timed out or blocked the lookup (`blocked` / `rate_limited` / `upstream_error`). Safe to retry.", "originalRequest": { "url": { "path": [ "rates", "quote" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"origin\": \"\",\n \"destination\": \"\",\n \"weight_kg\": \"\",\n \"volume_cm3\": \"\",\n \"service\": \"general\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Gateway", "code": 502, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6e9e1a2e-78fc-423c-a13e-dd407ae05c08", "name": "Key verification or the entitlement check is temporarily unavailable (`auth_unavailable`).", "originalRequest": { "url": { "path": [ "rates", "quote" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"origin\": \"\",\n \"destination\": \"\",\n \"weight_kg\": \"\",\n \"volume_cm3\": \"\",\n \"service\": \"general\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Service Unavailable", "code": 503, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"missing_key\",\n \"message\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "Air Cargo", "description": "", "item": [ { "id": "bc9b9b1e-dd75-472b-a1a2-17dac903667b", "name": "Health check", "request": { "name": "Health check", "description": {}, "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "5926c8a5-5eb1-46cf-9cb8-c2278b1aabe4", "name": "Service is up.", "originalRequest": { "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ok\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.navo24.com/v1/air", "type": "string" }, { "key": "apiKey", "value": "", "type": "string" } ], "info": { "_postman_id": "144ce6c1-ad2c-4787-a036-200e4f8c5ce8", "name": "Navo Air Cargo API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Air-cargo AWB tracking, live aircraft positions, and air-freight rate quotes. One backend serves two surfaces: aircargomcp.com (AWB tracking + the free prefix oracle + live aircraft positions) and airratesmcp.com (rate quotes). Tracking normalises every airline/platform connector onto an IATA Cargo-IMP milestone shape (RCS → DEP → ARR → RCF → NFD → DLV); the rich geo/route/datetime fields are structure-aligned with the SeaRates Air-Tracking envelope, so a caller who already consumes SeaRates reads this with the same shape. Paid endpoints take `Authorization: Bearer ` (or `X-API-Key: `) — one `tmcp_` family key entitled to the `aircargo` product. The `/prefix/{code}` oracle is free and unauthenticated. AI agents can use the hosted MCP server at https://mcp.aircargomcp.com/mcp instead, with the same key (without one only the resolve_awb_prefix tool answers).\n\nContact Support:\n Name: aircargomcp\n Email: hello@aircargomcp.com", "type": "text/plain" } } }