---
title: "Retrieve CHAMP flight status updates"
method: GET
path: "/integrations/air_waybills/flight_statuses/v1/{task_group_id}"
tags: ["/integrations/air_waybills"]
---

# Retrieve CHAMP flight status updates

`GET /integrations/air_waybills/flight_statuses/v1/{task_group_id}`

Retrieves all CHAMP flight status updates linked to the air waybill for a task group. | () -> (list[ChampFlightStatus1])

## Path parameters

- `task_group_id` string, required

## Response `200`

Successful Response

- ChampFlightStatus1[]
  - `schemaVersion` 1
  - `_id` string, required
  - `champId` string, required
  - `type` 'flight status', required
  - `messageHeader` CargojsonMessageHeader, required — [GENERATED/CONFIG] Message header with addressing and creation timestamp.
    - `addressing` CargojsonAddressing, required — [CONFIG] Routing addresses for the CargoHUB message.
      - `routeVia` CargojsonParticipantAddress — [CONFIG] PIMA address assigned during CHAMP onboarding.
        - `type` 'PIMA' | 'TTY' | 'CARRIER_CODE_3N' | 'IATA_CARRIER_CODE' | 'EMAIL' | 'WEBSITE' | 'UNNKOWN' — https://github.com/champ-cargosystems-gmbh/cargojson.champ.aero/blob/master/src/main/java/aero/champ/cargojson/common/ParticipantAddressType.java
        - `address` string, required
      - `routeAnswerVia` CargojsonParticipantAddress — [CONFIG] PIMA address assigned during CHAMP onboarding.
        - `type` 'PIMA' | 'TTY' | 'CARRIER_CODE_3N' | 'IATA_CARRIER_CODE' | 'EMAIL' | 'WEBSITE' | 'UNNKOWN' — https://github.com/champ-cargosystems-gmbh/cargojson.champ.aero/blob/master/src/main/java/aero/champ/cargojson/common/ParticipantAddressType.java
        - `address` string, required
      - `senderAddresses` CargojsonParticipantAddress[]
        - `type` 'PIMA' | 'TTY' | 'CARRIER_CODE_3N' | 'IATA_CARRIER_CODE' | 'EMAIL' | 'WEBSITE' | 'UNNKOWN' — https://github.com/champ-cargosystems-gmbh/cargojson.champ.aero/blob/master/src/main/java/aero/champ/cargojson/common/ParticipantAddressType.java
        - `address` string, required
      - `finalRecipientAddresses` CargojsonParticipantAddress[]
        - `type` 'PIMA' | 'TTY' | 'CARRIER_CODE_3N' | 'IATA_CARRIER_CODE' | 'EMAIL' | 'WEBSITE' | 'UNNKOWN' — https://github.com/champ-cargosystems-gmbh/cargojson.champ.aero/blob/master/src/main/java/aero/champ/cargojson/common/ParticipantAddressType.java
        - `address` string, required
      - `replyAnswerTo` CargojsonParticipantAddress[]
        - `type` 'PIMA' | 'TTY' | 'CARRIER_CODE_3N' | 'IATA_CARRIER_CODE' | 'EMAIL' | 'WEBSITE' | 'UNNKOWN' — https://github.com/champ-cargosystems-gmbh/cargojson.champ.aero/blob/master/src/main/java/aero/champ/cargojson/common/ParticipantAddressType.java
        - `address` string, required
    - `creationDate` string, date-time
    - `edifactData` CargojsonEdifactData — [CONFIG] Optional EDIFACT envelope data for legacy compatibility.
      - `messageReference` string, nullable
      - `interchangeControlReference` string, nullable
      - `commonAccessReference` string, nullable
      - `password` string, nullable
  - `airWaybillNumber` string, required
  - `originAndDestination` ChampOriginAndDestination
    - `origin` string, required
    - `destination` string, required
  - `quantity` ChampQuantity
    - `shipmentDescriptionCode` string, nullable
    - `numberOfPieces` integer, nullable
    - `weight` CargojsonWeight — Reusable weight amount + unit pair. Used for: - AirWayBill.weight -> [WEBCARGO] <NetWeight> (gross weight) - Charge.chargeable_weight -> [WEBCARGO] <TotalChargeableWeight> (billing weight) - ChargeItem.gross_weight -> [WEBCARGO] <NetWeight>
      - `amount` number, required
      - `unit` 'KILOGRAM' | 'POUND'
  - `totalNumberOfPieces` integer, nullable
  - `events` ChampFlightStatusEvent1[]
    - `type` string, required
    - `numberOfPieces` integer, nullable
    - `weight` CargojsonWeight — Reusable weight amount + unit pair. Used for: - AirWayBill.weight -> [WEBCARGO] <NetWeight> (gross weight) - Charge.chargeable_weight -> [WEBCARGO] <TotalChargeableWeight> (billing weight) - ChargeItem.gross_weight -> [WEBCARGO] <NetWeight>
      - `amount` number, required
      - `unit` 'KILOGRAM' | 'POUND'
    - `timeOfEvent` string, nullable
    - `timeOfEventTimePartQuality` string, nullable
    - `otherServiceInformation` string, nullable
    - `flight` string, nullable
    - `origin` string, nullable
    - `destination` string, nullable
    - `dateOfScheduledDeparture` string, nullable
    - `dateOfScheduledArrival` string, nullable
    - `timeOfScheduledDeparture` string, nullable
    - `timeOfScheduledArrival` string, nullable
    - `airportOfReceipt` string, nullable
    - `receivedFromName` string, nullable
    - `airportOfDelivery` string, nullable
    - `deliveryToName` string, nullable
    - `airportOfNotification` string, nullable
    - `notificationToName` string, nullable
  - `orgId` string, nullable — Must be a string starting with `org_`
  - `taskGroupId` string, nullable
  - `receivedAt` string, date-time, 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)