GET /tax-breakdown

GET /tax-breakdown

The TaxBreakdown endpoint provides the tax breakdown that applies to a specific flight product. 

HOW TO USE?

Use case flow can be followed by the consumer by requesting the GET method supplied as HATEOAS link in the response body of AvailableOffers & UpsellOffers.

HEADERS TO USE FOR REQUESTS

Parameter

Value

Authorization 

Bearer {{token}}

Content-Type 

application/json

Accept 

application/hal+json;charset=utf8

Accept-Language 

{{language}}-{{country}}

AFKL-TRAVEL-Host 

KL or AF

AFKL-TRAVEL-Country 

Country (overrides Accept-Language country)

GET

GET https://api.klm.com/opendata/offers/v1/flight-products/{id}/tax-breakdown

QUERY PARAMETERS

n/a (use HATEOAS link)

RESPONSE PARAMETERS

Name Type Multiplicity   Description
price Object 1 Price specification for the product.
..currency String 1 The currency used for prices in response.

Three letter currency code according to ISO 4217.
..pricePerPassengerTypes   Array of Objects    1-4 Price specification per passenger type.
.…passengerType String 1 Type of the passenger.

ADT, C14, CHD or INF
.…fare Number 1 Amount of the fare
.…taxes Array of Objects   1 List of taxes that apply to the flight product for the passenger type.
……..code String 1 Code of the type of tax.
……..amount Number 1 Amount applicable to the tax.
……..name String 1 Name of the type of tax in the language as specified in ContentLanguage header.
warning Object 0-99 Warning details
.code Number 1 Functional warning codes (1000-1999)
.name String 1

Name of the warning. Ex :OFA/FUNCTIONAL/INVALID_VALUE

- logger/Typology/name

.description String 1 Description of the warning
..errorinInputPath String 1

Description of the input Path where the warning occurred

errors Object
0-1 Error details
.code Number
1 Functional error codes (1000-1999)
Technical error codes (2000-2999)
Internal error codes (3000-3999)
.name String 1

Name of the error . Ex :OFA/TECHNICAL/INVALID_VALUE

- logger/Typology/name

.description String
1

Description of the error.

..errorinInputhPath String 1

Description of the input Path where the error occurred

HTTP STATUS CODE

HTTP status

Type

200 OK

500

INTERNAL_SERVER_ERROR


SIMPLE RESPONSE

{

    "price": {

        "pricesPerPassengerType": [

            {

                "passengerType": "INF",

                "taxes": [

                    {

                        "code": "YC",

                        "amount": 4.89,

                        "name": "US customs user fee"

                    },

                    {

                        "code": "US",

                        "amount": 31.42,

                        "name": "Internationale vervoersbelasting VS"

                    },

                    {

                        "code": "XA",

                        "amount": 4.44,

                        "name": "Animal and Plant Health Inspection Service (APHIS)-belasting VS"

                    },

                    {

                        "code": "XY",

                        "amount": 6.22,

                        "name": "Immigration and Naturalization Services (INS)-gebruikersbelasting VS"

                    },

                    {

                        "code": "AY",

                        "amount": 4.97,

                        "name": "Veiligheidsservicetoeslag passagiers burgerluchtvaart VS"

                    }

                ]

            },

            {

                "passengerType": "ADT",

                "taxes": [

                    {

                        "code": "YQ",

                        "amount": 233,

                        "name": "Internationale toeslag van de luchtvaartmaatschappij"

                    },

                    {

                        "code": "RN",

                        "amount": 14.38,

                        "name": "Luchthaven Passagiersservicetoeslag"

                    },

                    {

                        "code": "VV",

                        "amount": 0.5,

                        "name": "Geluidstoeslag"

                    },

                    {

                        "code": "CJ",

                        "amount": 12.17,

                        "name": "Veiligheidstoeslag"

                    },

                    {

                        "code": "YC",

                        "amount": 4.89,

                        "name": "US customs user fee"

                    },

                    {

                        "code": "US",

                        "amount": 31.42,

                        "name": "Internationale vervoersbelasting VS"

                    },

                    {

                        "code": "XA",

                        "amount": 4.44,

                        "name": "Animal and Plant Health Inspection Service (APHIS)-belasting VS"

                    },

                    {

                        "code": "XY",

                        "amount": 6.22,

                        "name": "Immigration and Naturalization Services (INS)-gebruikersbelasting VS"

                    },

                    {

                        "code": "AY",

                        "amount": 4.97,

                        "name": "Veiligheidsservicetoeslag passagiers burgerluchtvaart VS"

                    },

                    {

                        "code": "QX",

                        "amount": 7.3,

                        "name": "Luchthaven Passagiersservicetoeslag internationaal"

                    },

                    {

                        "code": "FR",

                        "amount": 10.35,

                        "name": "Franse luchthavenbelasting"

                    },

                    {

                        "code": "XF",

                        "amount": 4,

                        "name": "Toeslag passagiersvoorzieningen VS"

                    }

                ]

            },

            {

                "passengerType": "CHD",

                "taxes": [

                    {

                        "code": "YQ",

                        "amount": 233,

                        "name": "Internationale toeslag van de luchtvaartmaatschappij"

                    },

                    {

                        "code": "RN",

                        "amount": 14.38,

                        "name": "Luchthaven Passagiersservicetoeslag"

                    },

                    {

                        "code": "VV",

                        "amount": 0.5,

                        "name": "Geluidstoeslag"

                    },

                    {

                        "code": "CJ",

                        "amount": 12.17,

                        "name": "Veiligheidstoeslag"

                    },

                    {

                        "code": "YC",

                        "amount": 4.89,

                        "name": "US customs user fee"

                    },

                    {

                        "code": "US",

                        "amount": 31.42,

                        "name": "Internationale vervoersbelasting VS"

                    },

                    {

                        "code": "XA",

                        "amount": 4.44,

                        "name": "Animal and Plant Health Inspection Service (APHIS)-belasting VS"

                    },

                    {

                        "code": "XY",

                        "amount": 6.22,

                        "name": "Immigration and Naturalization Services (INS)-gebruikersbelasting VS"

                    },

                    {

                        "code": "AY",

                        "amount": 4.97,

                        "name": "Veiligheidsservicetoeslag passagiers burgerluchtvaart VS"

                    },

                    {

                        "code": "QX",

                        "amount": 7.3,

                        "name": "Luchthaven Passagiersservicetoeslag internationaal"

                    },

                    {

                        "code": "FR",

                        "amount": 10.35,

                        "name": "Franse luchthavenbelasting"

                    },

                    {

                        "code": "XF",

                        "amount": 4,

                        "name": "Toeslag passagiersvoorzieningen VS"

                    }

                ]

            }

        ],

        "currency": "EUR"

    }

}

Docs Navigation