GET /priceDetails v1

GET /priceDetails

The priceDetails endpoint provides some details on the price breakdown : how the price is built and the list of associated 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 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/travel/offers/v1/flight-products/{id}/price-details

QUERY PARAMETERS

n/a (use HATEOAS link)

RESPONSE PARAMETERS

Level Name Type Multiplicity   Description
1 priceDetails Object 1 Price details for the product.
2 totals Array of Objects
0..n Total amounts
3 currency String 1 The currency used for the total.

Three letter currency code according to ISO 4217.
3 amount Number 1 Total amount for the full price
2 pricePerPassengers  Array of Objects    1..9 Price total per passenger
3 passengerId Integer 1 Passenger id (same as the ones in the request)
3 amount Number 1 Total amount for the passenger
2 priceCategories Array of Objects   1..n Detail of each category of the price
3 code String 1

Possible values :  AIR_CHARGES / TAXES_FEES 

3 label String   1 Label associated to this price category
3 totals Array of Objects   1..n

Total description for the category

4 currency String 1 The currency used for the total price of the category

Three letter currency code according to ISO 4217.
4 amount Number 1 Total amount for the category
4 pricePerPassengers  Array of Objects   1..9 Price total per passenger for the category
5 passengerId Integer 1 Passenger id (same as the ones in the request)
5 amount Number 1 Total amount for the passenger for the category
3 priceComponents Array of Objects   1..n Detail of each component of the price
4 code String 1

Possible values :
FARE

 TAXES

 SURCHARGE

 PENALTY (used for rebooking case)

ADDITIONAL_PRODUCTS (like bundles)
BOOKING_FEE

4 label String 1 Label associated to this price component
4 currency String 1 The currency used for the total of the price component
Three letter currency code according to ISO 4217.
4 amount Number 1 Total amount of the price component
4 pricePerPassengers Array of Objects   1..9 Total amount for the passenger for the price component
5 passengerId Integer 1 Passenger id (same as the ones in the request)
5 amount Number 1 Total amount for the passenger for the  price component
4 priceComponentBreakdown Array Of Object 0..n List of taxes that apply to the flight product for the given product
5 code String 1 Tax code
5 label String 1 Tax code label
5 amount Number 1 Amount of the taxes for the tax code
5 pricePerPassengers Array of Object 1..9 Details price of the taxes for the specified code per passenger
6 passengerId Integer 1 Passenger id (same as the ones in the request)
6 amount Number 1 Tax amount for the passenger for this tax code
1 warning Object 0-99 Warning details
2 .code Number 1 Functional warning codes (1000-1999)
2 .name String 1

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

- logger/Typology/name

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

Description of the input Path where the warning occurred

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

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

- logger/Typology/name

2 .description String
1

Description of the error.

2 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


 

{
    "priceDetails": {
        "totals": [
            {
                "currency": "EUR",
                "amount": 557.47,
                "pricePerPassengers": [
                    {
                        "passengerId": 1,
                        "amount": 557.47
                    }
                ]
            }
        ],
        "priceCategories": [
            {
                "code": "AIR_CHARGES",
                "label": "Total amount excluding taxes",
                "totals": [
                    {
                        "currency": "EUR",
                        "amount": 557.00,
                        "pricePerPassengers": [
                            {
                                "passengerId": 1,
                                "amount": 557.00
                            }
                        ]
                    }
                ],
                "priceComponents": [
                    {
                        "code": "FARE",
                        "label": "Ticket(s)",
                        "currency": "EUR",
                        "amount": 557.00,
                        "pricePerPassengers": [
                            {
                                "passengerId": 1,
                                "amount": 557.00
                            }
                        ]
                    }
                ]
            },
            {
                "code": "TAXES_FEES",
                "label": "Taxes and fees",
                "totals": [
                    {
                        "currency": "EUR",
                        "amount": 0.47,
                        "pricePerPassengers": [
                            {
                                "passengerId": 1,
                                "amount": 0.47
                            }
                        ]
                    }
                ],
                "priceComponents": [
                    {
                        "code": "TAXES",
                        "label": "Taxes",
                        "currency": "EUR",
                        "amount": 0.47,
                        "pricePerPassengers": [
                            {
                                "passengerId": 1,
                                "amount": 0.47
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

 

}

Docs Navigation