Airport Charges API
The Airport Charges API is for the calculation of airport charges on a single-leg operation, i.e. departure charges from an origin airport plus arrival charges at a destination airport.
Operations
POST Airport Charges API v1
Airport Charges API v1
Request
URL: https://api.airportcharges.com/api/v1/route/airport/
METHOD: POST
HEADER: Authorization: Bearer <Your-Authorization-Token>
Request Body
OriginAirport: string
IATA/ICAO Code for departure airport.DestinationAirport: string
IATA/ICAO Code for arrival airport.ArrivalTime: string
YYYY-MM-DD hh:mm:ssDepartureTime: string
YYYY-MM-DD hh:mm:ssCurrency: string (Optional)
If currency is not provided, the main currency of each airport's charges will be used.
Note, SubTotal in the response will show "NA" in this case.MTOW: decimal
Maximum takeoff weight in tonnes.Capacity: int
Capacity of the aircraft.Passengers: int
Number of passengers on-board the aircraft.EquipmentCode: string
IATA/ICAO aircraft code.OriginParkingHours: decimal
If not set it will be defaulted to 3 hours.DestinationParkingHours: decimal
If not set it will be defaulted to 3 hours.FlightType: string: Business (Optional)
Alters charges for a typical Business Aviation service.
Example: Assumes no use of an air bridge.RequireChargesAt: string: AtleastOne or Both (Optional)
Default: Both
Set to AtLeastOne to display charges for one of the airports (origin or destination) even if charges for the other one are not available. If not set, or set to Both, then no results are returned when one airport’s charges are unavailable.
Example Request
{
"OriginAirport": "JFK",
"DestinationAirport": "HKG",
"DepartureTime": "2016-12-16 12:00:00",
"ArrivalTime": "2016-12-16 15:00:00",
"Currency": "USD",
"MTOW": "247.2",
"Capacity": "273",
"Passengers": "218",
"EquipmentCode": "772",
"OriginParkingHours": "4",
"DestinationParkingHours":"3"
}
Success Response
{
"ContentEncoding": "UTF-8",
"JsonRequestBehavior": 0,
"MaxJsonLength": 2147483647,
"RecursionLimit": 100,
"ContentType": "application/json",
"Data": {
"Status": "Success",
"OriginAirport": "New York - John F. Kennedy International Airport",
"DestinationAirport": "Hong Kong International Airport",
"Equipment": "B777-200",
"SubTotal": "11,139.475",
"OriginCharges": {
"Total": "8,535.05",
"TotalCurrency": "USD",
"BillingSources": [
[
{
"BillingSource": 1,
"Name": "Airport Charge",
"Value": "4,654.65",
"Currency": "USD",
"ChargeCategories": [
{
"ChargeCategory": 1,
"Name": "Runway Charges",
"Value": "3,253.65",
"Currency": "USD",
"ChargeElements": [
{
"ElementName": "Public Area Landing Fees",
"Condition": "Public Area Landing Fees (Non-Peak)",
"Calculation": " Maximum of (( (MGW (000lbs)) x 5.97),25)",
"CalculationCurrency": "USD",
"Value": "3,253.65",
"Currency": "USD"
}
]
},
{
"ChargeCategory": 2,
"Name": "Parking Charges",
"Value": "420.00",
"Currency": "USD",
"ChargeElements": [
{
"ElementName": "Public Aircraft Parking and Storage Area Charges",
"Condition": "MGW in excess of 200,000 pounds",
"Calculation": " ((Time on Ground) in hours/8) x (70 + 25 x ((MGW (000lbs) - 200)/25))",
"CalculationCurrency": "USD",
"Value": "420.00",
"Currency": "USD"
}
]
},
{
"ChargeCategory": 3,
"Name": "Passenger Charges",
"Value": "981.00",
"Currency": "USD",
"ChargeElements": [
{
"ElementName": "Passenger Facility Charge (PFC)",
"Condition": "Per departing passenger",
"Calculation": "(Passengers - Transit Passengers) x 4.50",
"CalculationCurrency": "USD",
"Value": "981.00",
"Currency": "USD"
}
]
}
]
},
{
"BillingSource": 3,
"Name": "Government Taxes",
"Value": "3,880.40",
"Currency": "USD",
"ChargeCategories": [
{
"ChargeCategory": 11,
"Name": "Government Charges",
"Value": "3,880.40",
"Currency": "USD",
"ChargeElements": [
{
"ElementName": "International Departure Tax",
"Condition": "Per departing international passenger",
"Calculation": "(Passengers - Transit Passengers) x 17.80",
"CalculationCurrency": "USD",
"Value": "3,880.40",
"Currency": "USD"
}
]
}
]
}
]
]
},
"DestinationCharges": {
"Total": "2,604.42",
"TotalCurrency": "USD",
"BillingSources": [
[
{
"BillingSource": 1,
"Name": "Airport Charge",
"Value": "2,604.42",
"Currency": "USD",
"ChargeCategories": [
{
"ChargeCategory": 1,
"Name": "Runway Charges",
"Value": "2,321.36",
"Currency": "USD",
"ChargeElements": [
{
"ElementName": "Landing Charge",
"Condition": "MTOW excedding 20 tonnes",
"Calculation": "2800 + ((MTOW (t) - 20) x 67)",
"CalculationCurrency": "HKD",
"Value": "2,321.36",
"Currency": "USD"
}
]
},
{
"ChargeCategory": 2,
"Name": "Parking Charges",
"Value": "283.06",
"Currency": "USD",
"ChargeElements": [
{
"ElementName": "Parking Charges",
"Condition": "Terminal Building Frontal Parking Stands",
"Calculation": " (((Time on Ground) in minutes)/15) x 183",
"CalculationCurrency": "HKD",
"Value": "283.06",
"Currency": "USD"
}
]
},
{
"ChargeCategory": 5,
"Name": "Infrastructure Charges",
"Value": "0.00",
"Currency": "USD",
"ChargeElements": [
{
"ElementName": "Airbridge Charge",
"Condition": "Airbridge Charge",
"Calculation": "0",
"CalculationCurrency": "HKD",
"Value": "0.00",
"Currency": "USD"
}
]
}
]
}
]
]
},
"ExchangeRates": [
{
"CurrencyFrom": "HKD",
"CurrencyTo": "USD",
"ExchangeRate": 0.1289
}
],
"Request": {
"RequestsLeft": 99,
"RequestsSentToday": 1,
"TotalTimeElapsed": "735 ms"
}
}
}
Errors
When everything goes well, we'll send the response code 200 along with your data. If there is a problem, you will receive a response with error details formatted in JSON. Error responses will have one of the following HTTP status codes:
403: Unauthorized Access
User is inactive.
User not permitted to access module.
API Inactive for user.
Requests exceeded limit.
Token Expired.400: Bad Request
There is a problem with your request.429: Too many requests
By default only 1 request is allowed per second.500: Internal Server Error
We messed up something. Please let us know.