---
title: "Gets the current state of a Booking."
method: GET
path: "/v1/bookings/{bookingReference}"
tags: ["Booking"]
---

# Gets the current state of a Booking.

`GET /v1/bookings/{bookingReference}`

## Request

- Base URL: `https://your.domain.com`
- URL: `https://your.domain.com/v1/bookings/{bookingReference}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/suntransfers/apis/st-spec-suntransfers-supplier-api-specification/docs/v1/bookings/:bookingReference/get.ts> (a function with typed inputs; its response is checked against the schema)

Requests to this endpoint that fail may be retried depending on the `Response Code`. See more in the Responses section.

## Path parameters

- `bookingReference` string, required

## Response `200`

`200 OK`: Booking found.

- GetBookingResponse: Represents the result of a request to get the current status of a Booking.
  - `bookingReference` string, required: The Suntransfers Booking reference identifier. This is currently a string starting with 'SUNTR_' followed by alphanumeric characters.
  - `status` 'Created' | 'PartiallyModified' | 'Modified' | 'PartiallyCancelled' | 'Cancelled', required: The current status of the Booking.
  - `createdAtUtc` string, date-time, required: An ISO 8601 date-time string in UTC.
  - `lastModifiedAtUtc` string, date-time, required: An ISO 8601 date-time string in UTC.
  - `transfers` TransferResponse[], required: The list of Transfers associated with the Booking.
    - `transferDateTime` string, date-time, required: An ISO 8601 date-time string in local time.
    - `status` 'Created' | 'Modified' | 'Cancelled', required: The current status of the Transfer.
    - `pickupDateTime` string, date-time, nullable: The local date and time of the Pickup.
    - `supplierReference` string: The Supplier's internal Transfer reference or ID.

## Other responses

- `400`: `400 Bad Request`: The details of the issues found on the request are present in the `detail` property of the response.
- `401`: `401 Unauthorized`: Credentials are likely out of sync. Contact Suntransfers as soon as possible via our official email to synchronize credentials. Attention: DO NOT specify any details about username, password, or authentication method in the response.
- `404`: `404 Not Found`: The Booking was not found.
- `500`: `500 Internal Server Error`: Suntransfers systems might retry this request later.
- `501`: `501 Not Implemented`: This operation is not supported by the API.

## Changes

- **2025-11-07** (v1) `7448f4760619`: 1 info
  - added the required property `transfers/items/status` to the response with the `200` status
- **2025-10-24** (v1) `55d59ca4a825`: 1 breaking
  - removed the required property `transfers/items/status` from the response with the `200` status

[Operation history](https://skmtc.dev/suntransfers/apis/st-spec-suntransfers-supplier-api-specification/changes/v1/bookings/:bookingReference/get.md)

---

[API](https://skmtc.dev/suntransfers/apis/st-spec-suntransfers-supplier-api-specification.md) - [All operations](https://skmtc.dev/suntransfers/apis/st-spec-suntransfers-supplier-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/suntransfers/apis/st-spec-suntransfers-supplier-api-specification/revisions/ba6e6a567dd2?raw)