POSTAPI key

Air-freight quote

POSTapi.aircargomcp.com/rates/quote

An all-in per-kg quote for a lane and weight. Computes chargeable weight from the volume, then applies weight breaks and surcharges.

Request body

originstringrequired

Origin airport IATA.

destinationstringrequired

Destination airport IATA.

weight_kgnumberrequired

Gross weight in kilograms.

volume_cm3number

Volume in cubic centimetres, for chargeable-weight.

Response fields

Derived from the example response.

dataobject

The payload. Everything an endpoint returns sits under this key.

data.originstring

Origin code (airport IATA or UN/LOCODE).

data.destinationstring

Destination code (airport IATA or UN/LOCODE).

data.chargeable_weight_kgnumber

Chargeable weight in kilograms.

data.net_per_kgnumber

Net rate per kilogram.

data.surcharge_per_kgnumber

Surcharges per kilogram.

data.total_chargenumber

All-in charge for the shipment.

data.currencystring

ISO currency code.

data.airline_iatastring

Airline 2-letter IATA code.

curl -X POST 'https://api.aircargomcp.com/rates/quote' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":"FRA","destination":"JFK","weight_kg":512,"volume_cm3":3200000}'

const res = await fetch("https://api.aircargomcp.com/rates/quote", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "origin": "FRA",
    "destination": "JFK",
    "weight_kg": 512,
    "volume_cm3": 3200000
  })
});
const data = await res.json();

import requests

res = requests.post(
    "https://api.aircargomcp.com/rates/quote",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
    json={
      "origin": "FRA",
      "destination": "JFK",
      "weight_kg": 512,
      "volume_cm3": 3200000
    },
)
data = res.json()

Response

{
  "data": {
    "origin": "FRA", "destination": "JFK",
    "chargeable_weight_kg": 533,
    "net_per_kg": 2.85,
    "surcharge_per_kg": 0.62,
    "total_charge": 1849.51,
    "currency": "EUR",
    "airline_iata": "LH"
  }
}