---
title: "List existing bookings"
method: GET
path: "/bookings"
tags: ["Bookings"]
---

# List existing bookings

`GET /bookings`

Returns a list of all trip bookings by the authenticated user.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

A list of bookings

- object — This is a generic request/response wrapper which contains both data and links which serve as hypermedia controls (HATEOAS).
  - `data` object[] — The wrapper for a collection is an array of objects.
    - `id` string, uuid — Unique identifier for the booking
    - `trip_id` string, uuid — Identifier of the booked trip
    - `passenger_name` string — Name of the passenger
    - `has_bicycle` boolean — Indicates whether the passenger has a bicycle.
    - `has_dog` boolean — Indicates whether the passenger has a dog.
  - `links` object — Links to the next and previous pages of a paginated response.
    - `self` string, uri
    - `next` string, uri
    - `prev` string, uri

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2025-03-12** `f98baa492089` — 4 info
  - added `subschema #2, subschema #3` to the response body `allOf` list for the response status `200` (media type: application/json)
  - added `subschema #2, subschema #3` to the response body `allOf` list for the response status `200` (media type: application/xml)
  - removed `subschema #2, subschema #3` from the response body `allOf` list for the response status `200` (media type: application/json)
  - removed `subschema #2, subschema #3` from the response body `allOf` list for the response status `200` (media type: application/xml)
- **2024-11-05** `954726dfc1b1` — 1 info
  - added the new optional `query` request parameter `limit`
- **2024-10-16** `5c1810762d13` — 5 breaking
  - the response's body type/format changed from ``/`` to `object`/`` for status `400` (media type: application/problem+json)
  - the response's body type/format changed from ``/`` to `object`/`` for status `401` (media type: application/problem+json)
  - the response's body type/format changed from ``/`` to `object`/`` for status `403` (media type: application/problem+json)
  - the response's body type/format changed from ``/`` to `object`/`` for status `429` (media type: application/problem+json)
  - …1 more
- **2024-10-15** `31abce16841b` — 1 info
  - added the new optional `query` request parameter `page`
- **2024-02-21** `ec0452670099` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bump-sh-examples/apis/train-travel-api/changes/bookings/get.md)

---

[API](https://skmtc.dev/bump-sh-examples/apis/train-travel-api.md) · [All operations](https://skmtc.dev/bump-sh-examples/apis/train-travel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bump-sh-examples/train-travel-api/revisions/f98baa492089/schema)