Tracking

The current order status and every parcel’s tracking for your CONNEX account’s orders.

Get tracking

GET/v1/tracking

The current order status and every parcel of one or more of your account's orders. Requires tracking:read. Orders belonging to other stores are never returned — a ref that is unknown to your account is simply absent from data, not an error.

Prefer webhooks for keeping a status current; poll this endpoint to backfill or reconcile, not every few seconds.

Query parameters

refsstringrequired: Comma-separated order references — the ref the store gave the order. Up to 50 per call, each 1–100 characters of A–Z a–z 0–9 . _ : -.

Each order in data

orderStatusstring: The order's own status. It can move before any parcel exists, and a cancellation ends the order whatever the last parcel said.
shipments[]array: Parcels, oldest update first. Empty until a parcel is booked.
shipments[].fastshipShipmentIdinteger: CONNEX shipment id; 0 if not yet assigned.
shipments[].trackingNostring: CONNEX tracking number.
shipments[].agentTrackingNostring: The last-mile carrier’s tracking number (UPS, DHL, …), when known.
shipments[].statusstring: Parcel status.
shipments[].providerstring | null: Carrier name.
shipments[].serviceAgentstring: Service code the parcel ships under.
shipments[].agentNamestring | null: Carrier service display name.
shipments[].updatedAtstring: ISO 8601 time of this snapshot.

Request

curl -G https://api.connexglobal.co/v1/tracking \
  -H "Authorization: Bearer $CONNEX_ACCESS_TOKEN" \
  --data-urlencode "refs=ORD-10432,ORD-10433"

Responsejson

{
  "data": {
    "ORD-10432": {
      "orderStatus": "SHIPPED",
      "shipments": [
        {
          "fastshipShipmentId": 884120,
          "trackingNo": "FS2604188412",
          "agentTrackingNo": "1Z999AA10123456784",
          "status": "OUT_FOR_DELIVERY",
          "provider": "UPS",
          "serviceAgent": "FSEXP-UPS",
          "agentName": "UPS Worldwide Express",
          "updatedAt": "2026-10-24T08:15:00.000Z"
        }
      ]
    },
    "ORD-10433": {
      "orderStatus": "CANCELLED",
      "shipments": []
    }
  }
}

Statuses

Order and parcel statuses share one vocabulary, upper-case with underscores. Treat an unknown value as displayable text, not an error — new statuses may be added.

Status	Meaning
`PENDING`	Order placed
`CONFIRMED`	Order confirmed
`PROCESSING`	Preparing shipment
`PICKED`	Picked up
`WAREHOUSE`	At the CONNEX warehouse
`SHIPPED`	In transit
`OUT_FOR_DELIVERY`	Out for delivery
`DELIVERED`	Delivered
`FAILED`	Shipment issue — needs attention
`RETURNING`	Returning to sender
`RETURNED`	Returned ends order
`CANCELLED`	Cancelled ends order
`REFUNDED`	Refunded ends order

When orderStatus is one that ends the order, show it in preference to the last parcel status — a parcel snapshot stops being updated exactly when it stops being true.