---
title: "Retrieve updates"
method: GET
path: "/integrations/cargoai_track_and_trace/updates/v1/{awb}"
tags: ["/integrations/cargoai_track_and_trace"]
---

# Retrieve updates

`GET /integrations/cargoai_track_and_trace/updates/v1/{awb}`

Retrieves stored CargoAi tracking updates for an AWB, latest first (the first item is the current state). | authz: order participant | () -> (list[CargoAiTrackAndTraceUpdate1])

## Path parameters

- `awb` string, required — IATA Air Waybill number: 3-digit airline prefix + 8-digit serial, e.g. '020-12345678'.

## Response `200`

Successful Response

- CargoAiTrackAndTraceUpdate1[]
  - `schemaVersion` 1
  - `awb` string, required — IATA Air Waybill number: 3-digit airline prefix + 8-digit serial, e.g. '020-12345678'.
  - `origin` string, nullable
  - `destination` string, nullable
  - `status` string, nullable
  - `weight` string, nullable
  - `pieces` string, nullable
  - `volume` string, nullable
  - `carbonEmission` string, nullable
  - `alerts` CargoAiTrackAndTraceAlert — The `alerts` object — early warning signals on shipment execution.
    - `level` 'OK' | 'WATCH' | 'AT_RISK' — Early-warning signal level on shipment execution (alerts.level).
    - `message` string, nullable
  - `oldEvents` CargoAiTrackAndTraceEvent[]
    - `code` string, nullable
    - `description` string, nullable
    - `eventDate` string, nullable
    - `eventLocation` string, nullable
    - `eventLocationCoord` string, nullable
    - `flight` CargoAiTrackAndTraceFlight — The `flight` object nested inside a tracking event.
      - `number` string, nullable
      - `origin` string, nullable
      - `destination` string, nullable
      - `originCoord` string, nullable
      - `destinationCoord` string, nullable
      - `date` string, nullable
      - `scheduledDeparture` string, nullable
      - `estimatedDeparture` string, nullable
      - `actualDeparture` string, nullable
      - `scheduledArrival` string, nullable
      - `estimatedArrival` string, nullable
      - `actualArrival` string, nullable
      - `carbonEmission` string, nullable
      - `distance` string, nullable
      - `duration` string, nullable
      - `flightUlds` CargoAiTrackAndTraceUld[]
        - `pieces` string, nullable
        - `uld` string, nullable
    - `weight` string, nullable
    - `volume` string, nullable
    - `pieces` string, nullable
    - `additionalInformation` CargoAiTrackAndTraceAdditionalInformation — Event `additionalInformation` (notifications, delivery, transfer).
      - `receivedFromName` string, nullable
      - `notificationToName` string, nullable
      - `deliveryToName` string, nullable
      - `transferredToCarrier` string, nullable
    - `eventUlds` CargoAiTrackAndTraceUld[]
      - `pieces` string, nullable
      - `uld` string, nullable
    - `isPlanned` boolean, nullable
    - `distance` string, nullable
    - `origin` string, nullable
    - `destination` string, nullable
    - `time` string, nullable
    - `flightNumber` string, nullable
    - `scheduledDepartureDate` string, nullable
    - `carbonEmission` string, nullable
    - `originCoord` string, nullable
    - `destinationCoord` string, nullable
    - `isPredicted` boolean, nullable
    - `predictedEventDate` string, nullable
    - `predictedEventDateP90` string, nullable
  - `newEvents` CargoAiTrackAndTraceEvent[]
    - `code` string, nullable
    - `description` string, nullable
    - `eventDate` string, nullable
    - `eventLocation` string, nullable
    - `eventLocationCoord` string, nullable
    - `flight` CargoAiTrackAndTraceFlight — The `flight` object nested inside a tracking event.
      - `number` string, nullable
      - `origin` string, nullable
      - `destination` string, nullable
      - `originCoord` string, nullable
      - `destinationCoord` string, nullable
      - `date` string, nullable
      - `scheduledDeparture` string, nullable
      - `estimatedDeparture` string, nullable
      - `actualDeparture` string, nullable
      - `scheduledArrival` string, nullable
      - `estimatedArrival` string, nullable
      - `actualArrival` string, nullable
      - `carbonEmission` string, nullable
      - `distance` string, nullable
      - `duration` string, nullable
      - `flightUlds` CargoAiTrackAndTraceUld[]
        - `pieces` string, nullable
        - `uld` string, nullable
    - `weight` string, nullable
    - `volume` string, nullable
    - `pieces` string, nullable
    - `additionalInformation` CargoAiTrackAndTraceAdditionalInformation — Event `additionalInformation` (notifications, delivery, transfer).
      - `receivedFromName` string, nullable
      - `notificationToName` string, nullable
      - `deliveryToName` string, nullable
      - `transferredToCarrier` string, nullable
    - `eventUlds` CargoAiTrackAndTraceUld[]
      - `pieces` string, nullable
      - `uld` string, nullable
    - `isPlanned` boolean, nullable
    - `distance` string, nullable
    - `origin` string, nullable
    - `destination` string, nullable
    - `time` string, nullable
    - `flightNumber` string, nullable
    - `scheduledDepartureDate` string, nullable
    - `carbonEmission` string, nullable
    - `originCoord` string, nullable
    - `destinationCoord` string, nullable
    - `isPredicted` boolean, nullable
    - `predictedEventDate` string, nullable
    - `predictedEventDateP90` string, nullable
  - `events` CargoAiTrackAndTraceEvent[]
    - `code` string, nullable
    - `description` string, nullable
    - `eventDate` string, nullable
    - `eventLocation` string, nullable
    - `eventLocationCoord` string, nullable
    - `flight` CargoAiTrackAndTraceFlight — The `flight` object nested inside a tracking event.
      - `number` string, nullable
      - `origin` string, nullable
      - `destination` string, nullable
      - `originCoord` string, nullable
      - `destinationCoord` string, nullable
      - `date` string, nullable
      - `scheduledDeparture` string, nullable
      - `estimatedDeparture` string, nullable
      - `actualDeparture` string, nullable
      - `scheduledArrival` string, nullable
      - `estimatedArrival` string, nullable
      - `actualArrival` string, nullable
      - `carbonEmission` string, nullable
      - `distance` string, nullable
      - `duration` string, nullable
      - `flightUlds` CargoAiTrackAndTraceUld[]
        - `pieces` string, nullable
        - `uld` string, nullable
    - `weight` string, nullable
    - `volume` string, nullable
    - `pieces` string, nullable
    - `additionalInformation` CargoAiTrackAndTraceAdditionalInformation — Event `additionalInformation` (notifications, delivery, transfer).
      - `receivedFromName` string, nullable
      - `notificationToName` string, nullable
      - `deliveryToName` string, nullable
      - `transferredToCarrier` string, nullable
    - `eventUlds` CargoAiTrackAndTraceUld[]
      - `pieces` string, nullable
      - `uld` string, nullable
    - `isPlanned` boolean, nullable
    - `distance` string, nullable
    - `origin` string, nullable
    - `destination` string, nullable
    - `time` string, nullable
    - `flightNumber` string, nullable
    - `scheduledDepartureDate` string, nullable
    - `carbonEmission` string, nullable
    - `originCoord` string, nullable
    - `destinationCoord` string, nullable
    - `isPredicted` boolean, nullable
    - `predictedEventDate` string, nullable
    - `predictedEventDateP90` string, nullable
  - `_id` string, required
  - `receivedAt` string, date-time, required
  - `source` 'webhook', required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)