🔌
CargoCONNECT
53 articles
4 Best practices to implement CargoAi's Quote & Book API
The Search Rates and Flights/POST endpoint replicates CargoAi marketplace search results and retrieves airline flights and routes, including…
Best practices for testing our CargoCONNECT APIs
Our success story relies not just on a great product. We understand that there is never a downtime in the air cargo industry, which is why…
Best practices to implement the Track & Trace API: should I select the subscription (push) or pull basis?
We're glad you asked! In our Track and Trace API, we offer the options to either subscribe to an AWB and automatically receive a call back e…
Both scheduled and actual arrival and departure times are available in the tracking endpoints. Is it possible to get estimated arrival/departure times and receive updates if there are any changes?
Q: Both scheduled and actual arrival and departure times are available in the tracking endpoints. Is it possible to get estimated arrival/de…
CargoCONNECT, the suite of APIs by CargoAi is here!
Want to know more about our API Solutions? Just click on this link ( Book air cargo with CargoCONNECT in your IT environment | CargoAi ) to…
CO2 emissions calculator
In order to provide our users the best toolbox to actively monitor, steer and eventually reduce shipments CO2 emissions, we have made availa…
Common Scenarios and Explanations for Quote & Book API
"Null" Response in "Charges," "OCDC," and "Handling Codes" Fields When the Schedule & Rate API response displays "null" under the "charges,"…
Deprecation policy
At CargoAi we are constantly working on the development of our product offerings and solutions. To ensure that our APIs remain state of the…
Does the API only return new tracking milestones for an AWB subscription?
Q: Does the API only return new tracking milestones for an AWB subscription? A: Not only. All information is sent with the subscription upda…
Does your Tracking data include data on airport Dwell times?
Q: Does your Tracking data include data on airport Dwell times? A: Dwell Time refers to the period an aircraft spends on the ground between…
For the shipment volume field, should we provide the volumetric volume or the volume in cubic meters?
All volumes are in cubic meter. The volume in Shipment is the total volume of the shipment. The volume in dimension is the piece group volum…
For what purpose can I use the API key received in RapidAPI? Can I access your direct dev environment?
When you sign up for an account in RapidAPI you will receive automatically an API key. You will use the API key throughout your testing phas…
GetAWBFailed, CheckAWBFailed & AgentStockFailed Errors
Are you getting the error message "GetAWBFailed", "CheckAWBFailed" or "AgentStockFailed" trying to perform a booking? All these errors are r…
How can I calculate the net rate (without surcharges) and the total net rate for my shipment?
To calculate your shipment cost correctly, it’s important to understand the difference between net rate , all-in rate , and total : Net rate…
How can I distinguish estimated and actual times as part of the tracking email updates?
Unfortunately, our email updates don’t include scheduled or actual times. That information is only available through the URL subscription, w…
How can I report a bug on CargoCONNECT APIs?
Contact us via the chat or at support+api@cargoai.co Please include as much information as possible when reporting a bug, including: · Provi…
How to map the best Tracking flow to ensure there is no gap in flight or event dates?
Flight or Event dates (e.g. departure, arrival, delivery) are not always registered by airlines in a consistent manner. Within a single carr…
How to subscribe and pay for the API plans?
Our API solutions are available on RapidAPI the leading API platform worldwide. You can create a free basic account to start testing and can…
I already made a booking, but I chose incorrectly. How can I inform the airline that I want to cancel it?
You can cancel all bookings via the API, there is a dedicated endpoint for that in our Quote & Book API.
I am getting an error informing me that my AWB number is wrong or not in my stock, but the AWB was provided by the airline itself. How can I fix this?
Unfortunately, these errors are only returned if the Airline API reject your booking with similar error. The best is to check with the airli…
I can see that over 100 airlines are available in the Quote & Book API, however I am not receiving results from over 100 airlines when I perform a search via the API. Why is that?
Please be aware that the list indicates all airlines which we are connected with, however all of them may either not be flying to your reque…
I have a direct API connection and I want to have access to FlyWindow, how does it work?
To have access to FlyWindow, you can use the User Provisioning API to set up users and allow them get this external link. Documentation abou…
I have a direct API integration for rates and I want to have access to FlyWindow. How do I get started?
Q: I have a direct API integration for rates and I want to have access to FlyWindow. How do I get started? A: You can get started by using t…
I made a booking on CargoAi but I received a 404 error when tracking my shipment with the flight_uuid?
Q: I made a booking on CargoAi but I received a 404 error when tracking my shipment with the flight_uuid? A: Please make sure your booking w…
I made a booking via the Quote & Book API. Can I retrieve and manage it from CargoMART?
Whilst you can now retrieve CargoMART bookings in your TMS via our CargoBRIDGE function, the other way around is not yet possible. In other…
I noticed a departure from AMS in the tracking data, but the carrier’s website doesn’t show any event from AMS. Why?
The departure event from AMS was received directly from the carrier’s API . The airline’s website often reflects a simplified or partial vie…
I noticed duplicate events in my tracking response, but with different flight information. What does it mean?
Q: I noticed duplicate events in my tracking response, but with different flight information. What does it mean? A: This means that your shi…
I performed a search via the Quote & Book API, but the rate returned via API is different from the rate returned on the CargoMART portal. Is this an issue?
If the search parameters are identical, you should be receiving the exact same results on CargoMART and CargoCONNECT. Please check your Char…
I put the airline prefix in the AWB field of my booking request, why was my booking rejected?
Please make sure the flight option you chose is eligible for Auto AWB, the feature that fetches an AWB from the airline stock when the AWB i…
I uploaded market rate sheets for a specific route, but no rates are showing. What’s missing?
In order to display rates from market rate sheets, we need to have both the rate sheet and the corresponding route schedule . If the route s…
I want to avoid seeing co-loader rates in search results. How can I do that?
To exclude co-loader rates, make sure to provide your IATA CASS number and ensure that the origin airport country matches the user office co…
I'm not an IATA CASS agent, can I still use CargoCONNECT, the Suite of APIs by CargoAi?
Well yes... but please read on, as there are some details for some specific API product. The traditional way the QUOTE & BOOK API works is t…
I'm testing the Quote & Book API, can I obtain rates when submitting only the accurate chargeable weight, and not necessarily all dimensions or random dimensions? Does it affect the API behavior?
Only the number of Pieces, Weight and Volume are mandatory and cannot be random, as they will be used to re-calculate the Chargeable Weight.…
I’m trying to figure out if a rate comes from a co-loader. Is that possible?
At this time, there is no way to identify whether a displayed rate is coming from a co-loader or directly from the airline. All rates appear…
In some of the Tracking Event messages, I noticed different values for weight, volume and/or pieces compared to the root object of the response?
Q: In some of the Tracking Event messages, I noticed different values for weight, volume and/or pieces compared to the root object of the re…
Is "CargoAirline” with IATA code 0000000 and CASS code: 0000 a test airline?
Indeed, CargoAirline this is our internal test airline which can be used for testing and demoing purposes.
It seems that your Tracking API can be used for past shipments. What is the maximum duration for which backdated shipments are supported?
Q: It seems that your Tracking API can be used for past shipments. What is the maximum duration for which backdated shipments are supported?…
Master list of airline charges & their charge basis
We are always here to support your internal mapping process in the best possible way. However, a master list with all airline charges and th…
The Quote & Book API is returning rates for oversized shipment without any remarks. Can you please confirm that the rates can be used for my oversize cargo?
The offered rates mainly depend on the type of rate you are receiving for your shipment. If you receive live rates (type "live"), this means…
Track & Trace - Receiving varying event responses
When you are tracking an AWB, it can happen that you receive varying results at different points in time. For example, at times you receive…
Track & Trace API Pricing Model explained
In our Track and Trace API, we offer the options to either subscribe to an AWB and automatically receive a call back every time we detect a…
Track and Trace API - Event Codes
Thank you for using our suite of APIs! To get you started and to understand the tracking API's event codes, here is a list of codes you will…
Track and Trace API: Status standardization across airlines
Once you have subscribed to our Track & Trace API, you'll start working on your internal status mapping. A frequent question is whether Carg…
Usage Rules
This section outlines rules that must be followed when using CargoCONNECT. API users who do not adhere to these rules or who otherwise abuse…
What are the different values for loadType and what do they mean ?
LoadType can accept bellow values for the moment: DIMENSIONS → to indicate that your shipment is coming with dimensions information TOTAL →…
What are the different values for weightType and what do they mean?
WeightType can accept bellow values for the moment: PER_ITEM → to indicate that your piece group weight is for one piece TOTAL → to indicate…
What does "AWBOptional" field in "features" of the flight object mean?
It means you can book the returned flight option without providing an AWB number.
What is the difference between Shipment and Piece for dimensions, weight and volume?
‘Pieces’, ‘weight’ and volume under shipment are the total values for the shipment. Under Piece they are the values for a piece group. For e…
What is the meaning of each SHC (Special Handling Code)?
SHCs (Special Handling Codes) are standardized for the industry and can be found here: SHC meanings .
What's the difference between eBookable airlines and eBookable origins?
eBookable Airlines is the list of airlines which we are connected to for online bookings. For example we have as eBookable airlines TK (Turk…
Who can use CargoCONNECT, the suite of APIs by CargoAi?
Need fresh, high-quality airfreight schedules, pricing or tracking data? We've got your back! We enable airfreight businesses of all sizes t…
Why can the airline change the chargeable weight returned in a rate query?
Q: Why can the airline change the chargeable weight returned in a rate query? A: The recalculation of chargeable weight is not limited to no…
Why do we already receive some event updates in the tracking update, even before these events have effectively happened?
Q: Why do we already receive some event updates in the tracking update, even before these events have effectively happened? A: We can receiv…