---
title: "Subscribe"
method: POST
path: "/integrations/cargoai_track_and_trace/subscribe/v1"
tags: ["/integrations/cargoai_track_and_trace"]
---

# Subscribe

`POST /integrations/cargoai_track_and_trace/subscribe/v1`

Starts CargoAi Track & Trace URL + e-mail updates for an AWB (which must already be recorded on a flight leg). Idempotent: re-subscribing a still-live AWB returns the existing subscription without calling CargoAi again. | authz: order participant operator | (CargoAiTrackAndTraceSubscribeReq) -> (CargoAiTrackAndTraceSubscription1)

## Request body

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

## 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)