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:ss

  • DepartureTime: string
    YYYY-MM-DD hh:mm:ss

  • Currency: 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.

© 2021 RDC Aviation Ltd. All Rights Reserved.

Powered by Azure API Management.