Skip to content

Shipment status with timestamps, straight into your system.

Read your air shipments through one API, or have every change sent to you as a signed webhook.

curl https://api.ga-oms.com/v1/shipments \
  -G -d mawb=000-12345675 \
  -H "Authorization: Bearer ga_live_••••"

// 200
{ "object": "list", "has_more": false,
  "data": [{
    "id": "shp_4f9x…",
    "mawb": "000-12345675",
    "phase": "customs",
    "hold": false,
    "eta": "2026-12-01T10:00:00-08:00"
  }] }
  1. Pre-alertprealertNov 9
  2. BookedbookedCX 880
  3. ArrivedarrivedNov 11, 10:05 pm
  4. ReleasedreleasedNov 12, 6:30 am
  5. In warehousein_warehouseNov 12, 10:15 am
  6. BreakdownbreakdownNov 12, 12:40 pm
  7. Shippedshippednot yet
One shipment as the API tells it: 000-12345675 at LAX, in the warehouse phase. Every shipment carries these seven checkpoints, each with whether it was reached and when.

Ask us

Call for the events since the last one you have, about once a minute. Nothing to host.

GET /v1/events?after=evt_e3-01JCX7…
Authorization: Bearer ga_live_••••

// 200
{ "object": "list", "has_more": false,
  "data": [{ "type": "shipment.updated",
    "changed": ["phase", "lines"], … }] }
Events

Or be told

Give us an https address. Each change arrives there, signed, usually within a minute.

POST https://erp.example.com/ga/webhooks
webhook-id: evt_e3-01JCX7…
webhook-timestamp: 1794521112
webhook-signature: v1,K5oZfzN95Z9U…

{ "type": "shipment.updated",
  "changed": ["phase", "lines"], … }
Webhooks
Errors that say what is wrong
Every refusal has a stable code, a sentence for a person and a page that explains it. Errors
A request id on every answer
Quote it to us and we open the exact call. You never have to hand over your key to get help.
Signatures you can check
Webhooks follow the Standard Webhooks specification, with working code in Node.js, Python, PHP and Java. Webhooks
One file for your tools
The whole API is one OpenAPI document that your client generator, Postman, Apifox or AI assistant can read: openapi.json
Additions only
Version 1 only grows. Nothing you rely on is renamed or removed. Change log