--- title: "FWB&FHL Sending" method: POST path: "/eawb" --- # FWB&FHL Sending `POST /eawb` ## Request - Base URL: `https://api.cargoai.co/solutions` - URL: `https://api.cargoai.co/solutions/eawb` - Auth: API key in header `x-api-key` This document outlines the process of sending FWB&FHL to airlines ## Headers - `x-api-key` string, required ## Request body - object - `awb_number` string, required: Master AWB number of your booking - `awb_status` string, required: Status of your booking at the time when eAWB is sent (can only be PENDING_DELIVERY) - `userEmail` string, required: Email address of the user sending the eAWB - used a channel to send airline's response - `userCompanyName` string, required: Company name of the user sending the eAWB - `isFhlOnly` boolean: Flag to indicate if the request is for FHL sending only - `hawbs` object[]: Details of the house awbs linked to your master awb - `mawbNumber` string: master AWB number - `slac` integer: number of loose items or pieces in a ULD - `hawb_number` string, required: house AWB number - `number_of_pieces` integer, required: number of pieces linked to the house AWB - `gross_weight` object, required: gross weight of the house AWB - `value` number, float, required: weight or volume value - `uom` 'K' | 'L' | 'MC' | 'CF', required: unit of measure of the weight (K for kg, L for lbs) or volume (MC for cubic meter, CF for cubic feet) - `locations` object, required: Origin and Destination airports of house AWB - `port_of_origin` object, required: Origin airport of the house AWB - `code` string, required: 3 letters code following IATA standards - `port_of_destination` object, required: Destination airport of the house AWB - `code` string, required: 3 letters code following IATA standards - `commodity` string: description of goods inside house AWB - `currency_code` string: 3 letters currency code (ISO 4217) - `charge_code` 'CC' | 'CZ' | 'CG' | 'PP' | 'PX' | 'PZ' | 'PG' | 'CP' | 'CX' | 'CM' | 'NC' | 'NT' | 'NZ' | 'NG' | 'NP' | 'NX' | 'CA' | 'CB' | 'CE' | 'CH' | 'PC' | 'PD' | 'PE' | 'PH' | 'PF': code describing the payment method of charges - `other` 'P' | 'C': Indicates wether the payment will be made at origin (prepaid 'P'), or at destination (collect 'C') - `values_for_carriage` number, float: value declared for the house AWB for carriage purposes - `values_for_custom` number, float: value declared for the house AWB for customs purposes - `values_for_insurance` number, float: value declared for the house AWB for insurances purposes - `handling` object: Additional handling information for your shipment to provide in the FWB - `specialServiceInformation` string: Special handling details to be mentioned in FWB. Max 65 characters - `otherServiceInformation` string: Other handling details to be mentioned in FWB. Max 65 characters - `specialHandling` object[]: Code indicating thatshipment may need use of special handling processes - `code` string, required: 3 letters code following IATA standards - `specialServiceRequest` string[]: Special service request (SSR) lines to be mentioned in FWB - `senderReference` object: References of the agent sending the shipment - `senderAirport` string: airport linked to the agent sending the shipment - `senderOfficeDesignator` 'FF' | 'FR' | 'FM': office designator of the agent sending the shipment - `shipper` object, required: Details related to the shipper - `name` string, required: name of the shipper or consignee - `account_number` string: account number in airline system of shipper or consignee. Max 47 characters. Not sent for notify, nor in FHL - `phone` string: phone number of shipper or consignee - `fax` string: fax number of shipper or consignee - `email` string: email address of shipper or consignee. In FHL, the shipper and consignee are only included when an email is set - `address` object: address of the shipper or consignee - `line1` string, required: address line1 of shipper or consignee - `line2` string: address line2 of shipper or consignee - `place` string: Mandatory if city code not provided. Place or location of the shipper or consignee - `city` object: city (code) mandatory if place not provided. City of the shipper or consignee - `code` string, required: 3 letters code for city, 2 letters code for country - `name` string: name of the city or country - `postal_code` string: postal code of the place/city - `state_province` string: state or province of the place/city. Mandatory when country.code is US or CA - `country` object, required: country of the place/city. Mandatory - `code` string, required: 2 letters ISO 3166-1 country code (2 to 3 letters accepted) - `name` string: name of the city or country - `consignee` object, required: Details related to the consignee - `name` string, required: name of the shipper or consignee - `account_number` string: account number in airline system of shipper or consignee. Max 47 characters. Not sent for notify, nor in FHL - `phone` string: phone number of shipper or consignee - `fax` string: fax number of shipper or consignee - `email` string: email address of shipper or consignee. In FHL, the shipper and consignee are only included when an email is set - `address` object: address of the shipper or consignee - `line1` string, required: address line1 of shipper or consignee - `line2` string: address line2 of shipper or consignee - `place` string: Mandatory if city code not provided. Place or location of the shipper or consignee - `city` object: city (code) mandatory if place not provided. City of the shipper or consignee - `code` string, required: 3 letters code for city, 2 letters code for country - `name` string: name of the city or country - `postal_code` string: postal code of the place/city - `state_province` string: state or province of the place/city. Mandatory when country.code is US or CA - `country` object, required: country of the place/city. Mandatory - `code` string, required: 2 letters ISO 3166-1 country code (2 to 3 letters accepted) - `name` string: name of the city or country - `eori` string: EORI number of the consignee. Sent in the FWB OCI line together with oci.origin_country_code - `notify` object: Details related to the person to notify regarding shipment's delivery - `name` string, required: name of the shipper or consignee - `account_number` string: account number in airline system of shipper or consignee. Max 47 characters. Not sent for notify, nor in FHL - `phone` string: phone number of shipper or consignee - `fax` string: fax number of shipper or consignee - `email` string: email address of the party to notify. The notify party is only included in the FWB when name and email are set - `address` object: address of the shipper or consignee - `line1` string, required: address line1 of shipper or consignee - `line2` string: address line2 of shipper or consignee - `place` string: Mandatory if city code not provided. Place or location of the shipper or consignee - `city` object: city (code) mandatory if place not provided. City of the shipper or consignee - `code` string, required: 3 letters code for city, 2 letters code for country - `name` string: name of the city or country - `postal_code` string: postal code of the place/city - `state_province` string: state or province of the place/city. Mandatory when country.code is US or CA - `country` object, required: country of the place/city. Mandatory - `code` string, required: 2 letters ISO 3166-1 country code (2 to 3 letters accepted) - `name` string: name of the city or country - `routingDetails` object[], required: Only first leg is mandatory. 3 iterations max. Details of the shipment routing for first origin to last destination - `from_airport_code` string, required: Origin of the flight - `to_airport_code` string, required: Destination of the flight - `carrier_code` string, required: Carrier code of the airline operating the flight. 2 alphanumeric characters (IATA code) - `flight_number` string: Flight identification number - `chargesDeclaration` object: Mandatory only for FWB. Details related to the payment of shipment charges - `currency_code` string, required: 3 letters currency code (ISO 4217) - `charge_code` 'CC' | 'CZ' | 'CG' | 'PP' | 'PX' | 'PZ' | 'PG' | 'CP' | 'CX' | 'CM' | 'NC' | 'NT' | 'NZ' | 'NG' | 'NP' | 'NX' | 'CA' | 'CB' | 'CE' | 'CH' | 'PC' | 'PD' | 'PE' | 'PH' | 'PF', required: code describing the payment method of charges - `weight_or_valuation` 'P' | 'C': Indicates wether the payment will be made at origin (prepaid 'P'), or at destination (collect 'C') - `values_for_carriage` number, float: value declared for carriage purposes. NVD is sent when empty or 0 - `values_for_custom` number, float: value declared for customs purposes. NCV is sent when empty or 0 - `values_for_insurance` number, float: value declared for insurance purposes. XXX is sent when empty or 0 - `rates` object[]: Mandatory only for FWB. Details related to the rate and commodities of the shipment - `number_of_pieces` integer, required: number of pieces/ULDs accepted for carriage - `gross_weight` object: gross weight of the shipment - `value` number, float, required: weight or volume value - `uom` 'K' | 'L' | 'MC' | 'CF', required: unit of measure of the weight (K for kg, L for lbs) or volume (MC for cubic meter, CF for cubic feet) - `volume` object: volume of the shipment. Mandatory when neither dims nor uld is provided - `value` number, float, required: weight or volume value - `uom` 'K' | 'L' | 'MC' | 'CF', required: unit of measure of the weight (K for kg, L for lbs) or volume (MC for cubic meter, CF for cubic feet) - `slac` integer: number of loose items or pieces in the shipment - `rate_class_code` 'B' | 'R' | 'S' | 'P' | 'M' | 'N' | 'Q' | 'K' | 'C' | 'X' | 'E' | 'U' | 'Y', required: description of a specific rate category - `commodity_item_number` string: IATA standard number to identify commodity - `chargeable_weight` number, float: chargeable weight of the shipment - `rate_or_charge` number, float: represents the rate or charge of the shipment - `charge_amount` number, float, required: total charge of the shipment - `nature_and_quantity_of_goods` string: description of the goods relative to the shipment - `hsc` integer[]: HScodes of the goods relative to the shipment - `dims` object[]: represents the different dimensions of the packages of the shipment - `pcs` integer, required: number of pieces of the piece group - `length` integer, required: length of the piece group - `width` integer, required: width of the piece group - `height` integer, required: height of the piece group - `uom` 'CMT' | 'INH', required: unit of measure of the piece group - `weight` number, float: total weight of the piece group - `volume` number, float: total volume of the piece group - `uld` object[]: provides shipment ULD numbers - `number` string, required: ULD number - `execution` object: Mandatory only for FWB. Details about the AWB execution - `date` string, required: date when the AWB is executed - `place` string, required: place where the AWB is executed - `shipper_signature` string, required: signature of the shipper executing the AWB - `carrier_signature` string, required: signature of the carrier executing the AWB - `oci` object: Other customs, security and regulatory control information - `origin_country_code` string, required: shipment origin country code for customs, regulatory control - `security` object: e-CSD security declaration group, emitted as the leading OCI group - `regulated_agent` string, required: National approval reference of the regulated agent - `issuer_type` string: One of RA, KC, AC, RC - empty treated as RA - `expiry_date` string: Format MMYY; required if issuer_type is RA/empty or KC - `screening_methods` string[]: One of PHS, VCK, XRY, EDS, RES, FRD, VPT, PRT, MDE, SIM, AOM - `security_status` string, required: One of SPX, SCO, NSC, SHR - `screening_datetime` string: Format DDMMHHMM; screening date/time - `screener_name` string: Name of the screener - `exemption_code` string: One of SMUS, MAIL, BIOM, DIPL, LFSM, NUCL, TRNS - `agent` object: Details related to the agent - `accountNumber` string: agent account number in airline system - `iata` string, required: agent IATA code - `cass` string: agent Cass code - `place` string, required: agent location place (city) - `name` string, required: Agent's name - `otherCharges` object[]: Additional charge information - `pc_indicator` string, required: Prepaid/Collect Indicator (P or C) - `charge_code` string, required: Charge code - `entitlement_code` string, required: Entitlement Code - `charge_amount` number, float, required: Charge Amount - `customsOrigin` string: Customs status of the goods under the applicable customs regime (e.g. "Z9"), not a country of origin ## Response `204` Message successfully sent to the airline. No response body. ## Other responses - `400`: 400 - `402`: Not enough credits left on your CargoCONNECT organization to send the message. - `403`: 403 - `500`: 500 ## Changes - **2026-11-03** `dfd7950d43d7`: 1 info - endpoint added [Operation history](https://skmtc.dev/cargoai/apis/solutions/changes/eawb/post.md) --- [API](https://skmtc.dev/cargoai/apis/solutions.md) - [All operations](https://skmtc.dev/cargoai/apis/solutions/llms.txt) - [OpenAPI document](https://skmtc.dev/cargoai/apis/solutions/revisions/dfd7950d43d7?raw)