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

# Retrieve subscription

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

Retrieves the stored CargoAi tracking subscription for an AWB. | authz: order participant | () -> (CargoAiTrackAndTraceSubscription1)

## Path parameters

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

## Response `200`

Successful Response

- CargoAiTrackAndTraceSubscription1
  - `schema_version` 1, required
  - `_id` string, required
  - `awb` string, required — IATA Air Waybill number: 3-digit airline prefix + 8-digit serial, e.g. '020-12345678'.
  - `created_by_user_id` string, required — Must be a string starting with `user_`
  - `created_by_org_id` string, required — Must be a string starting with `org_`
  - `subscribed_emails` string[]
  - `tracking_update_ids` string[]
  - `subscribed_at` string, date-time, required
  - `active_until` string, date-time, required
  - `last_update_received_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` 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)