Order Detail

POST

/api/v1/generic-api-service/flight/order-detail

The order detail endpoint returns the full detail of a single flight order by its orderId. It includes flight itineraries and segments, passenger and e-ticket information, contact details, receipt (billing) information and payment records.

curl --location 'https://test-api.etscore.com/api/v1/generic-api-service/flight/order-detail' \
--header 'Accept-Language: en-US' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "orderId": "49661695"
}'

JSON

{

"orderId": 49661695,

"orderStatus": "TICKET",

"salesDate": "2026-09-11T10:22:50",

"searchId": "5029md2matl3schcom2vbsvk4g7j4vc6",

"agencyId": 3640,

"agencyName": "ETSCore API",

"creationDate": "2026-09-11T10:22:50",

"currency": "EUR",

"clientRef": "EtscoreFlight212",

"flightItems": [

0: {

"flightId": 53137181,

"pnr": "42ED16",

"airline": "Ajet",

"flightStatus": "TICKET",

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

"salesDate": "2026-09-11T10:22:50",

"ticketUser": "[email protected]",

"itineraries": [

0: {

"flightIndex": 0,

"departureAirportCode": "AYT",

"arrivalAirportCode": "SAW",

"nonRefundable": true,

"noBag": false,

"segments": [

0: {

"segmentIndex": 0,

"segmentStatus": "DEPARTURE",

"flightNumber": "VF 3039",

"departureAirportCode": "AYT",

"arrivalAirportCode": "SAW",

"departureDateTime": "2026-10-10T05:15:00",

"arrivalDateTime": "2026-10-10T06:40:00",

"marketingAirlineCode": "VF",

"operatingAirlineCode": "VF",

"journeyDuration": 85,

"stopDurationMinutes": 0,

"technicalStop": false,

"technicalStopDurationMinutes": 0,

"departureCity": "Antalya",

"arrivalCity": "İstanbul",

"departureCountry": "Türkiye",

"arrivalCountry": "Türkiye",

"marketingAirline": "Ajet",

"operatingAirline": "Ajet",

"departureAirport": "Antalya",

"arrivalAirport": "Sabiha Gökçen",

"fareBasis": "WW26",

"departureCountryCode": "TR",

"arrivalCountryCode": "TR",

"cabinType": "ECONOMY",

"resBookCode": "W"

}

]

1: {

"flightIndex": 1,

"departureAirportCode": "SAW",

"arrivalAirportCode": "AYT",

"nonRefundable": true,

"noBag": false,

"segments": [

0: {

"segmentIndex": 0,

"segmentStatus": "ARRIVAL",

"flightNumber": "VF 3008",

"departureAirportCode": "SAW",

"arrivalAirportCode": "ESB",

"departureDateTime": "2026-10-30T21:15:00",

"arrivalDateTime": "2026-10-30T22:20:00",

"operatingAirlineCode": "TK",

"journeyDuration": 65,

"stopDurationMinutes": 105,

"operatingAirline": "Türk Hava Yolları",

"fareBasis": "JAJETVIP",

"cabinType": "ECONOMY",

"resBookCode": "J"

1: {

"segmentIndex": 1,

"segmentStatus": "ARRIVAL",

"flightNumber": "VF 4010",

"departureAirportCode": "ESB",

"arrivalAirportCode": "AYT",

"departureDateTime": "2026-10-31T00:05:00",

"arrivalDateTime": "2026-10-31T01:15:00",

"fareBasis": "WADDW26",

"resBookCode": "W"

}

]

}

]

}

"passengers": [

0: {

"name": "OMER",

"surname": "ERGAN",

"birthDate": "1990-02-09",

"male": true,

"paxType": "ADULT",

"tcknNo": "<national-id>",

"passengerPassaportCountry": "TR",

"etickets": [

0: {

"eticketNumber": "2042452443067",

"ticketStatus": "TICKETED",

"eticketFinal": {

"pnr": "42ED16",

"eticketNumber": "2042452443067",

"eticketStatus": "TICKETED",

"fare": 25.01,

"serviceFee": 2,

"tax": {

"VQ": 4.07,

"YR": 0,

"other": 0,

"total": 4.07

"totalAmount": 31.08,

"baggageInfo": "1PIECES & 15(KG), 1PIECES & 15(KG)",

"saleDatetime": "2026-09-11T10:22:50",

"departureDatetime": "2026-10-10T05:15:00",

"serviceId": 53137181

}

]

}

"contact": {

"email": "[email protected]",

"mobilePhoneNumber": "905000000000"

"receipts": [

0: {

"name": "OMER",

"surname": "ERGAN",

"email": "[email protected]",

"city": "İstanbul",

"country": "TURKEY",

"address1": "Merdivenköy Mh. Nur Sk. No:1/8 C Blok Kadıköy / İSTANBUL",

"address2": "Merdivenköy Mh. Nur Sk. No:1/8 C Blok Kadıköy / İSTANBUL",

"zipCode": "34000",

"receiptName": "ETSTUR",

"nationalId": "<national-id>",

"company": false,

"companyName": "ETSTUR",

"taxNumber": "<tax-number>",

"taxOffice": "Büyük Mükellefler V.D.",

"electronicReceipt": true,

"needReceiptFlag": false,

"notTCCitizen": false,

"notTCCompany": false,

"privateCompany": false

}

"payments": [

0: {

"paymentType": "Debit",

"referenceNumber": 0,

"totalPrice": 116.5,

"success": true

}

]

}

Name	Type	Required	Description
orderId	string	Yes	The unique order identifier (e.g. from Flight Orders or Reservation Create).

Name	Type	Required	Description
orderId	int	Yes	Unique order identifier.
orderStatus	string	Yes	Order status (e.g. `TICKET`).
salesDate	string	Yes	Date and time the order was sold.
searchId	string	Yes	The search session identifier the order originated from.
agencyId	int	Yes	Identifier of the agency that created the order.
agencyName	string	Yes	Name of the agency.
creationDate	string	Yes	Order creation date and time.
currency	string	Yes	Currency of the order (e.g. `EUR`).
clientRef	string	No	Client reference supplied at reservation.
flightItems	object-array	Yes	Flight/ticket records for the order.
flightItems/flightId	int	Yes	Internal flight/ticket record identifier.
flightItems/pnr	string	Yes	Passenger Name Record (booking reference).
flightItems/airline	string	Yes	Airline name.
flightItems/flightStatus	string	Yes	Status of the flight item (e.g. `TICKET`).
flightItems/creationDate	string	Yes	Creation timestamp.
flightItems/salesDate	string	Yes	Sale timestamp.
flightItems/ticketUser	string	Yes	User/account that issued the ticket.
flightItems/itineraries	object-array	Yes	Itineraries per leg.
flightItems/itineraries/flightIndex	int	Yes	Leg index: `0` departure, `1` return.
flightItems/itineraries/departureAirportCode	string	Yes	Origin IATA code of the leg.
flightItems/itineraries/arrivalAirportCode	string	Yes	Destination IATA code of the leg.
flightItems/itineraries/nonRefundable	boolean	Yes	Whether the leg is non-refundable.
flightItems/itineraries/noBag	boolean	Yes	Whether the leg has no baggage allowance.
flightItems/itineraries/segments	object-array	Yes	Segments of the leg.
flightItems/itineraries/segments/segmentIndex	int	Yes	Index of the segment within the leg.
flightItems/itineraries/segments/segmentStatus	string	Yes	Segment direction/status (e.g. `DEPARTURE`, `ARRIVAL`).
flightItems/itineraries/segments/flightNumber	string	Yes	Flight number including airline code (e.g. `VF 3039`).
flightItems/itineraries/segments/departureDateTime	string	Yes	Segment departure local date and time.
flightItems/itineraries/segments/arrivalDateTime	string	Yes	Segment arrival local date and time.
flightItems/itineraries/segments/marketingAirlineCode	string	Yes	Marketing airline code.
flightItems/itineraries/segments/operatingAirlineCode	string	Yes	Operating airline code.
flightItems/itineraries/segments/journeyDuration	int	Yes	Segment flying time in minutes.
flightItems/itineraries/segments/stopDurationMinutes	int	Yes	Layover after this segment in minutes.
flightItems/itineraries/segments/technicalStop	boolean	No	Whether there is a technical stop.
flightItems/itineraries/segments/departureCity	string	Yes	Departure city name.
flightItems/itineraries/segments/arrivalCity	string	Yes	Arrival city name.
flightItems/itineraries/segments/departureAirport	string	Yes	Departure airport name.
flightItems/itineraries/segments/arrivalAirport	string	Yes	Arrival airport name.
flightItems/itineraries/segments/fareBasis	string	Yes	Fare basis code of the segment.
flightItems/itineraries/segments/cabinType	string	Yes	Cabin type (e.g. `ECONOMY`).
flightItems/itineraries/segments/resBookCode	string	Yes	Reservation booking (class) code (e.g. `W`).
passengers	object-array	Yes	Passengers on the order.
passengers/name	string	Yes	Passenger given name.
passengers/surname	string	Yes	Passenger surname.
passengers/birthDate	string	Yes	Date of birth.
passengers/male	boolean	Yes	Gender: `true` male, `false` female.
passengers/paxType	string	Yes	Passenger type (e.g. `ADULT`).
passengers/tcknNo	string	No	National identity number of the passenger.
passengers/passengerPassaportCountry	string	No	Passport/nationality country code.
passengers/etickets	object-array	Yes	E-tickets issued for the passenger.
passengers/etickets/eticketNumber	string	Yes	Electronic ticket number.
passengers/etickets/ticketStatus	string	Yes	Ticket status (e.g. `TICKETED`).
passengers/etickets/eticketFinal	object	Yes	Finalized ticket/pricing detail: `pnr`, `eticketNumber`, `eticketStatus`, `fare`, `serviceFee`, `tax`, `totalAmount`, `baggageInfo`, `saleDatetime`, `departureDatetime`, `serviceId`.
passengers/etickets/eticketFinal/serviceFee	decimal	No	Service fee expressed in the pricing currency.
passengers/etickets/eticketFinal/tax	object	No	Standardized tax breakdown: `VQ`, `YR`, `other`, `total` (aligned with flight search & detail responses).
contact	object	Yes	Contact info: `email`, `mobilePhoneNumber`.
receipts	object-array	No	Receipt/billing records: name, surname, email, city, country, address, zipCode, receiptName, nationalId, company, companyName, taxNumber, taxOffice and flags.
payments	object-array	Yes	Payment records.
payments/paymentType	string	Yes	Payment method (e.g. `Debit`).
payments/referenceNumber	int	Yes	Payment reference number.
payments/totalPrice	decimal	Yes	Total amount paid.
payments/success	boolean	Yes	Whether the payment was successful.

Errors specific to Order Detail (9 codes). Common gateway and authentication errors apply to all endpoints and are listed once in the central reference.

🔎

Validation— fix the request and retry

Group	Code	Message	Description
Validation	904128	Inventory validation error.	Returned when the request payload fails schema validation or required fields are missing. Correct the request parameters and send the request again.
Validation	904200	Flight service validation error: {0}	Returned during flight operations when validation on the remote flight provider side fails. Correct the request parameters and send the request again.

Not found— verify the identifier

Group	Code	Message	Description
Not found	904209	No flight order record found for the given criteria.	Returned when no flight order record matches the specified query parameters (date range, order ID, or status). Check query parameters.
Not found	904216	No flight sales report record found for the given criteria.	Returned when no flight sales report records are found matching the requested filter criteria. Verify date range and filters.

Rate limit— slow down and retry later

Group	Code	Message	Description
Rate limit	901010	You have exceeded the limit of requests sent per unit time. You can send {1} requests in {0} seconds.	Returned when the rate limit configured for your sales channel / IP is exceeded. Slow down your request rate and retry after the specified window.

System— retry with backoff; contact support if persistent

Group	Code	Message	Description
System	904003	Unexpected error occured.	Returned when an unexpected system error occurs while processing the flight request. Retry after a short wait; if the issue persists, contact Etscore support.
System	904201	Flight service system error: {0}	Returned when an internal system error occurs within the remote flight provider service. Retry with backoff; contact support if persistent.
System	904211	Remote order ID is null. Order detail sync cannot be performed.	Returned during order synchronization when the remote provider order ID is missing. Contact support if persistent.
System	904212	Failed to fetch order details from remote flight service.	Returned when synchronization fails while retrieving order details from the remote flight provider. Retry later or contact support.

Common errors not shown here. Gateway, authentication and header errors apply to every endpoint. → See the central Error Codes reference.