Track by Flight UUID

Changed on
get/track

Request

  • Base URL
    https://api.cargoai.co/solutions
  • URL
    https://api.cargoai.co/solutions/track
  • Auth
    API key in header x-api-key

Query parameters

awbstring

Air waybill number to track, format XXX-NNNNNNNN (for example 020-12345675). Send awb, flight-uuid, or both.

flight-uuidstring

flightUUID returned when the booking was created: returns the booking updates, flight itinerary and shipment details with the tracking events. Send awb, flight-uuid, or both.

Headers

x-api-keystring required

Response

200

flightUUIDstring
awbstring

Example response

[
  {
    "flightUUID": "1bc492d0-bbee-11f0-8f9c-86c2340adebc",
    "awb": "000-15019804",
    "flight": {
      "flightUUID": "1bc492d0-bbee-11f0-8f9c-86c2340adebc",
      "airlineCode": "00",
      "flightNumber": "00867",
      "arrivalTime": "2025-11-10T06:00:00+08:00",
      "arrivalAirport": "SIN",
      "departureTime": "2025-11-09T19:00:00+01:00",
      "departureAirport": "XCR",
      "latestAcceptanceTime": "2025-11-09T14:00:00+01:00",
      "timeOfAvailability": "2025-11-10T11:00:00+08:00",
      "legs": [
        {
          "flightNumber": "00867",
          "arrivalTime": "2025-11-10T06:00:00+08:00",
          "arrivalAirport": "SIN",
          "departureTime": "2025-11-09T19:00:00+01:00",
          "departureAirport": "XCR",
          "bodyType": "Widebody",
          "aircraftCode": "777",
          "co2": {
            "value": 265.9386359118521
          }
        }
      ],
      "features": {
        "bookable": true,
        "awbOptional": true
      },
      "rates": [
        {
          "id": "1bc492b9-bbee-11f0-8f9c-86c2340adebc",
          "name": "Spot",
          "type": "live",
          "currency": "EUR",
          "netRate": 5.94,
          "allInRate": 6.08,
          "total": 1010,
          "charges": [
            {
              "label": "Fuel surcharge",
              "rate": 0.06,
              "type": "CHARGEABLE_WEIGHT",
              "code": "fsc"
            }
          ],
          "isSpotQuoteRate": true,
          "handlingCodes": [
            "GCR"
          ]
        }
      ],
      "available": true,
      "source": "AI-MOCK",
      "awbPrefixes": [
        "000"
      ],
      "airlineConditions": "\n\t1- Offer subject to capacity when booking.\n\t2- Quotation reference to be imperatively mentioned when booking.\n\t3- This quotation is valid for the packaging indicated only, in the event of modification, please make a new request to the sales department.\n\t4- Taxes (IRC – MYC – etc…) subject to change without notice.\n\t5- In the event of cancellation or no show, we reserve the right to pass on all or part of the costs\n\t- Cancellation 72 hours before the departure of the truck and/or the flight (working hours): invoicing 50% of the amount of the freight\n\t- Cancellation 48 hours before the departure of the truck and/or the flight (working hours): invoicing of 75% of the amount of the freight\n\t- Cancellation 24 hours before the departure of the truck and/or the flight (working hours): invoicing of 100% of the amount of the freight\n\t- In the case of a no show (no presentation of the freight): invoicing of 100% of the amount of the freight\n\t- In the case of a low show (discount less than 50% of the reserved taxable weight): invoicing of 75% of the reserved taxable weight\n",
      "contacts": [
        "tests@cargoai.co"
      ],
      "handlingInfoLink": "https://www.cargoai.co/terms",
      "ghaName": "Mocked GHA",
      "hle": "19:00",
      "ghaAddress": "Airport road, Cargo Terminal, Mocked Cargo building"
    },
    "shipment": {
      "product": "GCR",
      "weight": 100,
      "pieces": 1,
      "chargeableWeight": 167,
      "dimensions": [
        {
          "height": 100,
          "length": 100,
          "width": 100,
          "weight": 100,
          "pieces": 1,
          "volume": 1,
          "stackable": true,
          "weightType": "PER_ITEM",
          "loadType": "DIMENSIONS"
        }
      ],
      "specialHandlingCodes": [
        "GCR"
      ],
      "volume": 1,
      "measurementUnit": "METRIC"
    },
    "bookingResponse": {
      "flightUUID": "1bc492d0-bbee-11f0-8f9c-86c2340adebc",
      "bookingStatus": "DELIVERED",
      "awb": "000-15019804"
    }
  }
]

Changes