Skip to main content
GET
/
v2
/
bookings
List bookings
curl --request GET \
  --url https://staging.api.prexsell.com/v2/bookings \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "bookings": [
      {
        "id": "bkg_1",
        "createdAt": "2026-06-14T00:05:00.000Z",
        "updatedAt": "2026-06-14T00:05:00.000Z",
        "departureDate": "2026-06-15T03:30:00.000Z",
        "status": "Upcoming",
        "bookingRequiredBy": "2026-06-14T00:25:00.000Z",
        "paymentRequiredBy": "2026-06-14T00:25:00.000Z",
        "tickets": [
          {
            "id": "ord_abc",
            "bookingId": "bkg_1",
            "note": null,
            "status": "Processing",
            "paymentStatus": "Unpaid",
            "departureDate": "2026-06-15T00:00:00.000Z",
            "source": "PrexSell",
            "refundAmount": null,
            "passenger": {
              "id": "pass_1",
              "firstName": "Іван",
              "lastName": "Петренко",
              "email": "ivan@example.com",
              "phones": [
                {
                  "id": "ph_1",
                  "phone": "+380501234567",
                  "messengers": [
                    "Viber"
                  ]
                }
              ]
            },
            "price": {
              "id": "price-1",
              "amount": 1450,
              "currency": "UAH"
            },
            "discount": {
              "id": "disc-1",
              "name": "Студентська знижка",
              "rule": "Percent",
              "amount": 100,
              "startDate": "2026-06-01T00:00:00.000Z",
              "endDate": "2026-12-31T23:59:59.000Z"
            },
            "slices": [
              {
                "id": "sl_abc",
                "duration": 480,
                "departureDate": "2026-06-15T00:00:00.000Z",
                "arrivalDate": "2026-06-15T08:00:00.000Z",
                "seat": {
                  "id": "seat_1",
                  "label": "12A"
                },
                "bus": {
                  "id": "bus-1",
                  "seatsQty": 50,
                  "registrationNumber": "AA1234BB",
                  "brand": "Mercedes-Benz",
                  "model": "Tourismo",
                  "images": [
                    {
                      "id": "img-1",
                      "url": "https://example.com/bus.jpg",
                      "name": "Bus exterior"
                    }
                  ]
                },
                "carriage": {
                  "id": "carriage-1",
                  "name": "Автопарк №1",
                  "phones": [
                    "+380501234567"
                  ]
                },
                "route": {
                  "id": "route-1",
                  "name": "Київ — Варшава",
                  "slug": "kyiv-warsaw",
                  "description": "Щоденний нічний рейс",
                  "company": {
                    "id": "company-1",
                    "name": "PrexSell Lines",
                    "slug": "prexsell-lines",
                    "ceo": "Олена Коваль",
                    "partnerCompany": null,
                    "logoUrl": "https://example.com/logo.png",
                    "email": "ops@prexsell-lines.com",
                    "website": "https://prexsell-lines.com",
                    "rules": "Пасажир має прибути за 20 хвилин до відправлення.",
                    "socials": [
                      "https://facebook.com/prexsell.lines"
                    ]
                  },
                  "permissions": [
                    {
                      "id": "perm-1",
                      "role": "Agent",
                      "accesses": [
                        "book",
                        "cancel"
                      ],
                      "type": "Partner"
                    }
                  ],
                  "services": [
                    {
                      "id": "svc-1",
                      "name": "Wi-Fi"
                    },
                    {
                      "id": "svc-2",
                      "name": "Кондиціонер"
                    }
                  ]
                },
                "stops": [
                  {
                    "id": "stop-1",
                    "departureTime": "06:30",
                    "arrivalTime": null,
                    "platform": "3",
                    "arrivalDate": null,
                    "place": "Центральний автовокзал",
                    "latitude": 50.4501,
                    "longitude": 30.5234,
                    "city": {
                      "id": "city-kyiv",
                      "name": "Київ",
                      "slug": "kyiv",
                      "country": "UA",
                      "timeZone": "Europe/Kyiv"
                    }
                  },
                  {
                    "id": "stop-2",
                    "departureTime": null,
                    "arrivalTime": "08:00",
                    "platform": "5",
                    "arrivalDate": "2026-06-15T08:00:00.000Z",
                    "place": "Dworzec Zachodni",
                    "latitude": 52.2297,
                    "longitude": 21.0122,
                    "city": {
                      "id": "city-warsaw",
                      "name": "Варшава",
                      "slug": "warsaw",
                      "country": "PL",
                      "timeZone": "Europe/Warsaw"
                    }
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "total": 1
  }
}

Authorizations

x-api-key
string
header
required

Partner API key, sent in the x-api-key request header. Required for bookable offer search and all booking operations. To obtain a key, register as a PREXSELL partner in the backoffice (backoffice.prexsell.com, or staging.backoffice.prexsell.com for staging) and contact support if you need help.

Query Parameters

departureDate
string<date>

Filter to bookings whose UTC onboarding instant falls on this calendar day (YYYY-MM-DD). Omit to list all your bookings, newest first.

Example:

"2024-01-20"

take
integer
default:50

Number of bookings to return (max 50).

Required range: 1 <= x <= 50
Example:

50

skip
integer | null
default:0

Number of bookings to skip.

Required range: x >= 0
Example:

0

Response

Paginated booking list.

data
object
required

Paginated booking list result.