Reverse Inquire

POST

/api/v1/generic-api-service/flight/reverse/inquire

The reverse inquire endpoint is used before cancelling a PNR to find out the cancellation penalty and the refundable amount. It does not cancel the PNR — it only returns the penalty and refund breakdown. The returned reverseToken is then used to perform the actual cancellation, and it is valid until expireTime.

cURL

curl --location 'https://test-api.etscore.com/api/v1/generic-api-service/flight/reverse/inquire' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "orderId": "49661695",
    "pnr": "42ED16"
}'

Request

JSON

{

"orderId": "49661695",

"pnr": "42ED16"

}

Response

JSON

{

"success": true,

"reverseToken": "00b1804f-0791-4480-9842-758fa48cd119",

"orderId": 49661695,

"pnr": "42ED16",

"orderStatus": "TICKET",

"availableReverseType": "REFUND_PNR",

"passengers": [

0: {

"passengerType": "ADULT",

"passengerGender": "MALE",

"passengerName": "OMER",

"passengerSurname": "ERGAN",

"passengerId": 69369876

}

],

"eticketPenaltyList": [

0: {

"eticketNumber": "2042452443067",

"fare": 98.51,

"tax": {

"VQ": 9.86,

"YR": 0,

"other": 0,

"total": 9.86

},

"penaltyAmount": 108.37

}

],

"totalPenaltyAmount": 68.53,

"totalRefundAmount": 39.85,

"currency": "EUR",

"saleDate": "2026-09-11T10:22:43",

"expireTime": "2026-09-11T11:34:37.052910876"

}

Request Details

Name	Type	Required	Description
orderId	string	Yes	The unique order identifier of the booking.
pnr	string	Yes	The PNR (booking reference) to inquire the cancellation penalty for.

Response Details

Name	Type	Required	Description
success	boolean	Yes	Indicates whether the inquiry was processed successfully.
reverseToken	string	Yes	Token representing this cancellation quote. Use it to perform the actual cancellation before it expires.
orderId	int	Yes	The order identifier.
pnr	string	Yes	The PNR the quote applies to.
orderStatus	string	Yes	Current order status (e.g. TICKET).
availableReverseType	string	Yes	The type of reverse operation available (e.g. REFUND_PNR).
passengers	object-array	Yes	Passengers included in the cancellation.
passengers/passengerType	string	Yes	Passenger type (e.g. ADULT).
passengers/passengerGender	string	Yes	Passenger gender (e.g. MALE, FEMALE).
passengers/passengerName	string	Yes	Passenger given name.
passengers/passengerSurname	string	Yes	Passenger surname.
passengers/passengerId	int	Yes	Internal passenger identifier.
eticketPenaltyList	object-array	Yes	Per e-ticket penalty breakdown.
eticketPenaltyList/eticketNumber	string	Yes	Electronic ticket number the penalty applies to.
eticketPenaltyList/fare	decimal	Yes	Base fare of the e-ticket.
eticketPenaltyList/tax	object	Yes	Tax breakdown for the e-ticket: VQ, YR, other, total.
eticketPenaltyList/penaltyAmount	decimal	Yes	Penalty amount calculated for this e-ticket.
totalPenaltyAmount	decimal	Yes	Total cancellation penalty to be charged.
totalRefundAmount	decimal	Yes	Total amount to be refunded after the penalty.
currency	string	Yes	Currency of the amounts (e.g. EUR).
saleDate	string	Yes	Original sale date and time of the ticket.
expireTime	string	Yes	Time until which the reverseToken (this quote) is valid.