---
title: "Create"
method: POST
path: "/shipping/cargo_on_flight_air_waybills/create/v1"
tags: ["/shipping/cargo_on_flight_air_waybills"]
---

# Create

`POST /shipping/cargo_on_flight_air_waybills/create/v1`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/shipping/cargo_on_flight_air_waybills/create/v1`
- Auth: HTTP bearer

Creates the air waybill for a confirmed cargo-on-flight booking: the parties, rating, charges, and security declaration sent to the airline as an FWB. | authz_personas=[task_group_coordinator_operators] | (CargoOnFlightAirWaybillClientCreate1) -> (CargoOnFlightAirWaybill1)

## Request body

- CargoOnFlightAirWaybillClientCreate1
  - `schema_version` 1, required
  - `cargo_on_flight_booking_id` string, required
  - `iata_cass_office_id` string, nullable
  - `issuing_agent_name` string, nullable
  - `shipper` CargoOnFlightAirWaybillParty1, required: A shipper, consignee, or also-notify party.
    - `name` string, required
    - `account_number` string, nullable
    - `address_line_1` string, required
    - `address_line_2` string, nullable
    - `city_name` string, required
    - `city_iata` string, nullable
    - `state_province` string, nullable
    - `postal_code` string, nullable
    - `country_code` string, required
    - `phone_number` string, nullable
    - `fax_number` string, nullable
    - `email_address` string, email, nullable
  - `consignee` CargoOnFlightAirWaybillParty1, required: A shipper, consignee, or also-notify party.
    - `name` string, required
    - `account_number` string, nullable
    - `address_line_1` string, required
    - `address_line_2` string, nullable
    - `city_name` string, required
    - `city_iata` string, nullable
    - `state_province` string, nullable
    - `postal_code` string, nullable
    - `country_code` string, required
    - `phone_number` string, nullable
    - `fax_number` string, nullable
    - `email_address` string, email, nullable
  - `also_notify` CargoOnFlightAirWaybillParty1: A shipper, consignee, or also-notify party.
    - `name` string, required
    - `account_number` string, nullable
    - `address_line_1` string, required
    - `address_line_2` string, nullable
    - `city_name` string, required
    - `city_iata` string, nullable
    - `state_province` string, nullable
    - `postal_code` string, nullable
    - `country_code` string, required
    - `phone_number` string, nullable
    - `fax_number` string, nullable
    - `email_address` string, email, nullable
  - `rate_lines` CargoOnFlightAirWaybillRateLine1[], required
    - `number_of_pieces` integer, required
    - `gross_weight_kilograms` number, required
    - `volume_cubic_meters` number, nullable
    - `rate_class_code` 'B' | 'C' | 'E' | 'K' | 'M' | 'N' | 'P' | 'Q' | 'R' | 'S' | 'U' | 'X' | 'Y', required: IATA rate class codes, e.g. M minimum, N normal, Q quantity, C specific commodity.
    - `commodity_item_number` string, nullable
    - `chargeable_weight_kilograms` number, nullable
    - `rate_or_charge` number, nullable
    - `total_charge_amount` number, nullable
    - `nature_and_quantity_of_goods` string, required
    - `harmonized_commodity_codes` string[]
    - `dimensions` CargoOnFlightAirWaybillDimension1[]
      - `number_of_pieces` integer, required
      - `length_inches` number, required
      - `width_inches` number, required
      - `height_inches` number, required
    - `uld_numbers` string[]
  - `charges_declaration` CargoOnFlightAirWaybillChargesDeclaration1, required: Currency, payment, and declared values, for the master or a house air waybill.
    - `currency_code` string, required
    - `charge_code` 'CA' | 'CB' | 'CC' | 'CE' | 'CG' | 'CH' | 'CM' | 'CP' | 'CX' | 'CZ' | 'NC' | 'NG' | 'NP' | 'NT' | 'NX' | 'NZ' | 'PC' | 'PD' | 'PE' | 'PF' | 'PG' | 'PH' | 'PP' | 'PX' | 'PZ', required: IATA Cargo-IMP method of payment codes, e.g. PP all charges prepaid, CC all charges collect.
    - `payment_weight_valuation` 'prepaid' | 'collect'
    - `payment_other_charges` 'prepaid' | 'collect'
    - `declared_value_for_carriage` number, nullable
    - `declared_value_for_customs` number, nullable
    - `declared_value_for_insurance` number, nullable
  - `other_charges` CargoOnFlightAirWaybillOtherCharge1[]
    - `payment_condition` 'prepaid' | 'collect', required
    - `other_charge_code` string, required
    - `entitlement` 'due_agent' | 'due_carrier', required
    - `charge_amount` number, required
  - `special_service_request` string, nullable
  - `other_service_information` string, nullable
  - `customs_origin_code` string, nullable
  - `consignment_security_declaration` CargoOnFlightAirWaybillConsignmentSecurityDeclaration1: The OCI consignment security declaration (e-CSD).
    - `country_code` string, required
    - `regulated_entity_category` 'regulated_agent' | 'known_consignor' | 'account_consignor' | 'regulated_carrier', required
    - `regulated_entity_identifier` string, required
    - `expiry_mmyy` string, nullable
    - `security_status` 'SPX' | 'SCO' | 'SHR' | 'NSC', required
    - `screening_methods` CargoOnFlightAirWaybillScreeningMethodEnum1[]
    - `screening_exemption` 'SMUS' | 'MAIL' | 'BIOM' | 'DIPL' | 'LFSM' | 'NUCL' | 'TRNS'
    - `screened_at_timestamp` string, date-time, nullable
    - `screener_name` string, nullable
  - `shippers_certification` string, required
  - `carriers_execution` CargoOnFlightAirWaybillCarriersExecution1, required: When, where, and by whom the AWB was executed for the carrier (usually the agent).
    - `executed_on_date` string, date, required
    - `place` string, required
    - `authorisation_signature` string, required

## Response `200`

Successful Response

- CargoOnFlightAirWaybill1
  - `schema_version` 1, required
  - `_id` string, required
  - `cargo_on_flight_booking_id` string, required
  - `order_id` string, required
  - `task_group_id` string, required
  - `iata_cass_office_id` string, required
  - `created_by_org_id` string, required: Must be a string starting with `org_`
  - `created_by_user_id` string, nullable: Must be a string starting with `user_`
  - `issuing_agent_name` string, nullable
  - `shipper` CargoOnFlightAirWaybillParty1, required: A shipper, consignee, or also-notify party.
    - `name` string, required
    - `account_number` string, nullable
    - `address_line_1` string, required
    - `address_line_2` string, nullable
    - `city_name` string, required
    - `city_iata` string, nullable
    - `state_province` string, nullable
    - `postal_code` string, nullable
    - `country_code` string, required
    - `phone_number` string, nullable
    - `fax_number` string, nullable
    - `email_address` string, email, nullable
  - `consignee` CargoOnFlightAirWaybillParty1, required: A shipper, consignee, or also-notify party.
    - `name` string, required
    - `account_number` string, nullable
    - `address_line_1` string, required
    - `address_line_2` string, nullable
    - `city_name` string, required
    - `city_iata` string, nullable
    - `state_province` string, nullable
    - `postal_code` string, nullable
    - `country_code` string, required
    - `phone_number` string, nullable
    - `fax_number` string, nullable
    - `email_address` string, email, nullable
  - `also_notify` CargoOnFlightAirWaybillParty1: A shipper, consignee, or also-notify party.
    - `name` string, required
    - `account_number` string, nullable
    - `address_line_1` string, required
    - `address_line_2` string, nullable
    - `city_name` string, required
    - `city_iata` string, nullable
    - `state_province` string, nullable
    - `postal_code` string, nullable
    - `country_code` string, required
    - `phone_number` string, nullable
    - `fax_number` string, nullable
    - `email_address` string, email, nullable
  - `rate_lines` CargoOnFlightAirWaybillRateLine1[]
    - `number_of_pieces` integer, required
    - `gross_weight_kilograms` number, required
    - `volume_cubic_meters` number, nullable
    - `rate_class_code` 'B' | 'C' | 'E' | 'K' | 'M' | 'N' | 'P' | 'Q' | 'R' | 'S' | 'U' | 'X' | 'Y', required: IATA rate class codes, e.g. M minimum, N normal, Q quantity, C specific commodity.
    - `commodity_item_number` string, nullable
    - `chargeable_weight_kilograms` number, nullable
    - `rate_or_charge` number, nullable
    - `total_charge_amount` number, nullable
    - `nature_and_quantity_of_goods` string, required
    - `harmonized_commodity_codes` string[]
    - `dimensions` CargoOnFlightAirWaybillDimension1[]
      - `number_of_pieces` integer, required
      - `length_inches` number, required
      - `width_inches` number, required
      - `height_inches` number, required
    - `uld_numbers` string[]
  - `charges_declaration` CargoOnFlightAirWaybillChargesDeclaration1, required: Currency, payment, and declared values, for the master or a house air waybill.
    - `currency_code` string, required
    - `charge_code` 'CA' | 'CB' | 'CC' | 'CE' | 'CG' | 'CH' | 'CM' | 'CP' | 'CX' | 'CZ' | 'NC' | 'NG' | 'NP' | 'NT' | 'NX' | 'NZ' | 'PC' | 'PD' | 'PE' | 'PF' | 'PG' | 'PH' | 'PP' | 'PX' | 'PZ', required: IATA Cargo-IMP method of payment codes, e.g. PP all charges prepaid, CC all charges collect.
    - `payment_weight_valuation` 'prepaid' | 'collect'
    - `payment_other_charges` 'prepaid' | 'collect'
    - `declared_value_for_carriage` number, nullable
    - `declared_value_for_customs` number, nullable
    - `declared_value_for_insurance` number, nullable
  - `other_charges` CargoOnFlightAirWaybillOtherCharge1[]
    - `payment_condition` 'prepaid' | 'collect', required
    - `other_charge_code` string, required
    - `entitlement` 'due_agent' | 'due_carrier', required
    - `charge_amount` number, required
  - `special_service_request` string, nullable
  - `other_service_information` string, nullable
  - `customs_origin_code` string, nullable
  - `consignment_security_declaration` CargoOnFlightAirWaybillConsignmentSecurityDeclaration1: The OCI consignment security declaration (e-CSD).
    - `country_code` string, required
    - `regulated_entity_category` 'regulated_agent' | 'known_consignor' | 'account_consignor' | 'regulated_carrier', required
    - `regulated_entity_identifier` string, required
    - `expiry_mmyy` string, nullable
    - `security_status` 'SPX' | 'SCO' | 'SHR' | 'NSC', required
    - `screening_methods` CargoOnFlightAirWaybillScreeningMethodEnum1[]
    - `screening_exemption` 'SMUS' | 'MAIL' | 'BIOM' | 'DIPL' | 'LFSM' | 'NUCL' | 'TRNS'
    - `screened_at_timestamp` string, date-time, nullable
    - `screener_name` string, nullable
  - `shippers_certification` string, required
  - `carriers_execution` CargoOnFlightAirWaybillCarriersExecution1, required: When, where, and by whom the AWB was executed for the carrier (usually the agent).
    - `executed_on_date` string, date, required
    - `place` string, required
    - `authorisation_signature` string, required
  - `latest_fwb_message` CargoOnFlightAirWaybillFwbMessage1: The latest send of the FWB, and the airline's answer to it.
    - `cargo_on_flight_integration` 'air_canada' | 'cargoai' | 'manual', required
    - `status` 'sent' | 'accepted' | 'rejected', required
    - `sent_at_timestamp` string, date-time, required
    - `responded_at_timestamp` string, date-time, nullable
    - `response_provenance` 'airline' | 'manual'
    - `responded_by_user_id` string, nullable: Must be a string starting with `user_`
    - `airline_response` string, nullable
  - `created_at_timestamp` string, date-time, required
  - `updated_at_timestamp` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-13** `2aa61055d20a`: 1 warning
  - added the new `air_canada` enum value to the `latest_fwb_message/anyOf[subschema #1: CargoOnFlightAirWaybillFwbMessage1]/cargo_on_flight_integration` response property for the response status `200`
- **2026-10-06** `cedb208482ba`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/chrt/apis/chrt-fastapi/changes/shipping/cargo_on_flight_air_waybills/create/v1/post.md)

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) - [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/chrt/apis/chrt-fastapi/revisions/6f428e2e2b98?raw)