API Reference

This page list all the codes and associated description and http status for all booking operations performed on CargoCONNECT API

❗️

Important Notice

The following list highlights the most common errors encountered during the booking process, as identified by CargoAi, but is far from being exhaustive.

Please note that, due to the complexity of the market and the wide variety of potential errors that airlines may return, you may encounter additional errors beyond those listed here.

Please check at the examples available in API endpoint description for generic error message.

Error CodeDescriptionHttp status
GetAWBFailedSelected airline experiences issues with their AWB stock. Please use your own AWB or book with another airline.400
CheckAWBFailedThe AWB you provided for the booking is already in use. Please use another AWB number to proceed.400
UseAWBFailedThe AWB provided is restricted. Please use another AWB number to proceed.400
AgentStockFailedProvided AWB is not assigned to your office. Please proceed with another AWB.400
ProductOfferExpiredThis airline offer has expired and is no longer valid. Please perform a new search to receive a valid offer.400
ActivateCargoWALLETAccording to this airline, the iata cass used for the booking is unknown. Please activate your CargoWALLET to proceed with your booking.400
BookingWindowFailledChosen flight for booking is outside allowed booking window for this airline. Please proceed with another option inside the booking window or book with another airline.400
DimensionsInvalidDimensions provided for this shipment have been rejected by the airline. Please proceed with another option or book with another airline.400
NotEnoughCapacitySelected flight is already full. Please proceed with another option or book with another airline. 400
FlightNotAvailableSelected flight has been closed or cancelled by the airline. Please proceed with another option or book with another airline.400
TemporaryErrorOccurred;
UnknownErrorOccurred
Airline Server seems to face unexpected temporary error. Please try again later or book with another airline.500
InvalidAgent; CustomerIDInvalidAgent details are unknown on airline side. Please verify agent details before to proceed with the booking.400
MinConnectionTimeFailedFlight itinerary does not match minimum connection time regarding airline's business rule. Please proceed with another option.400
OriginDestInvalidOrigin and destination are not valid for provided flight itinerary. Please proceed with another option.400
SHCFailedSpecial Handling Code (SHC) provided are invalid or not applicable. Please make sure the used code is valid with the selected airline.400
AllotmentIDInvalidProvided Allotment ID is not known on airline's side. Please verify allotment ID before to proceed.400
ProductNotAllowedSelected product is not applicable for this booking.400
missing user informationUser information are missing from booking request.400
FlightUUID and RateId are already usedOption has already been booked and can't be book a second time. Please proceed with another option.500
your api-key is not allowedAPI Key is not authorized to perform booking operation.403
failure due to request body malformedRequest body does not match expected struct. Please verify your request before to proceed.400