---
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}`

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.

---

[API](https://skmtc.net/suntransfers/apis/st-spec-suntransfers-supplier-api-specification.md) · [All operations](https://skmtc.net/suntransfers/apis/st-spec-suntransfers-supplier-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suntransfers/st-spec-suntransfers-supplier-api-specification/versions/af3b2f961b6a/schema)