---
title: "Retrieve one or more booking orders"
method: GET
path: "/orders"
tags: ["Booking"]
---

# Retrieve one or more booking orders

`GET /orders`

Given one or more criteria in the query string, one or more matching booking orders will be returned.

Results will also be paged based on `offset` and `size`.

## Query parameters

- `customerPhoneNumber` string
- `customerEmail` string
- `passengerTravelDocumentNumber` string
- `offset` integer
- `size` integer
- `dateTimeStart` string, date-time
- `dateTimeEnd` string, date-time
- `orderStatus` 'creating' | 'ready' | 'cancelled' | 'completed' | 'error'

## Response `200`

OK

- OrdersResponse
  - `message` string — message returned by server side if there is any

## Other responses

- `400` — Bad Request

## Changes

- **2021-08-16** `df240d562bd4` — 3 breaking, 4 info
  - removed the enum value `pending` from the `query` request parameter `orderStatus`
  - removed the required property `orders/items/flights` from the response with the `200` status
  - removed the required property `orders/items/flights` from the response with the `400` status
  - added the new enum value `creating` to the `query` request parameter `orderStatus`
  - …3 more
- **2021-08-04** `a988ec9f3541` — 2 breaking, 5 info
  - the response's body type/format changed from `array`/`` to ``/`` for status `200`
  - removed the media type `text/plain` for the response with the status `400`
  - api tag `Booking` added
  - api tag `Orders` removed
  - …3 more
- **2021-07-20** `704267da2188` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/newpathfly/apis/virtual-interlining-api/changes/orders/get.md)

---

[API](https://skmtc.dev/newpathfly/apis/virtual-interlining-api.md) · [All operations](https://skmtc.dev/newpathfly/apis/virtual-interlining-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newpathfly/virtual-interlining-api/revisions/422128cc2430/schema)