Flight Orders

POST

/api/v1/generic-api-service/flight/orders?page=0&size=100

The orders endpoint returns a paginated list of flight orders (bookings) filtered by a date range. Each item summarizes an order — PNR, route, direction, status, amount and dates. Use the page and size query parameters to page through results.

cURL

curl --location 'https://test-api.etscore.com/api/v1/generic-api-service/flight/orders?page=0&size=100' \
--header 'Accept-Language: en-US' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
    "filterType": "SALES",
    "startDate": "2026-09-11",
    "endDate": "2026-09-11"
}'

Request

JSON

{

"filterType": "SALES",

"startDate": "2026-09-11",

"endDate": "2026-09-11"

}

Response

JSON

{

"content": [

0: {

"orderId": 49661695,

"pnr": "42ED16",

"pax": 1,

"provider": "Ajet Test",

"airline": "Ajet",

"direction": "ROUNDTRIP",

"flightType": "DOMESTIC",

"cabType": "ECONOMY",

"parkur": "AYT-SAW",

"statute": "TICKET",

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

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

"totalAmount": 116.5,

"currency": "EUR",

"paymentType": "Debit"

},

1: {

"orderId": 49661659,

"pnr": "42ECTE",

"pax": 1,

"provider": "Ajet Test",

"airline": "Ajet",

"direction": "ROUNDTRIP",

"flightType": "DOMESTIC",

"cabType": "ECONOMY",

"parkur": "SAW-AYT",

"statute": "REFUND_PNR",

"departureDate": "2026-09-27T02:55:00",

"eticketSaleDate": "2026-09-11T07:23:56",

"totalAmount": 191.71,

"currency": "EUR",

"paymentType": "Debit"

}

],

"pageable": {

"pageNumber": 0,

"pageSize": 100,

"sort": {

"sorted": false,

"empty": true,

"unsorted": true

},

"offset": 0,

"paged": true,

"unpaged": false

},

"totalElements": 25,

"totalPages": 1,

"last": true,

"size": 100,

"number": 0,

"sort": {

"sorted": false,

"empty": true,

"unsorted": true

},

"numberOfElements": 25,

"first": true,

"empty": false

}

Request Details

Name	Type	Required	Description
filterType	string	Yes	The type of date filter to apply. SALES filters by e-ticket sale date.
startDate	string	Yes	Start of the date range in yyyy-MM-dd format.
endDate	string	Yes	End of the date range in yyyy-MM-dd format.

Response Details

Name	Type	Required	Description
content	object-array	Yes	The list of orders on the current page.
content/orderId	int	Yes	Unique order identifier.
content/pnr	string	Yes	Passenger Name Record (booking reference).
content/pax	int	Yes	Number of passengers on the order.
content/provider	string	Yes	Provider/source of the booking (e.g. Ajet Test).
content/airline	string	Yes	Airline name (e.g. Ajet).
content/direction	string	Yes	Trip direction: ONEWAY or ROUNDTRIP.
content/flightType	string	Yes	Flight scope: DOMESTIC or INTERNATIONAL.
content/cabType	string	Yes	Cabin type (e.g. ECONOMY).
content/parkur	string	Yes	Route in ORIGIN-DESTINATION IATA format (e.g. AYT-SAW).
content/statute	string	Yes	Order status (e.g. TICKET, REFUND_PNR).
content/departureDate	string	Yes	Departure date and time of the (first) flight.
content/eticketSaleDate	string	Yes	Date and time the e-ticket was sold/issued.
content/totalAmount	decimal	Yes	Total amount of the order.
content/currency	string	Yes	Currency of the amount (e.g. EUR).
content/paymentType	string	Yes	Payment method (e.g. Debit).
pageable	object	Yes	Pagination request info: pageNumber, pageSize, offset, paged, unpaged, sort.
totalElements	int	Yes	Total number of orders matching the filter across all pages.
totalPages	int	Yes	Total number of pages.
number	int	Yes	Current page index (zero-based).
size	int	Yes	Page size used for this response.
numberOfElements	int	Yes	Number of orders returned on the current page.
first	boolean	Yes	Whether this is the first page.
last	boolean	Yes	Whether this is the last page.
empty	boolean	Yes	Whether the current page has no elements.
sort	object	Yes	Sort state: sorted, unsorted, empty.

Errors

Errors specific to Flight Orders (7 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.

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