---
title: "Return a booking"
method: GET
path: "/v3/scheduling/bookings/{booking_id}"
tags: ["Bookings"]
---

# Return a booking

`GET /v3/scheduling/bookings/{booking_id}`

Returns the specified Booking object.

Nylas validates the provided session ID and uses it to retrieve the related
[Configuration object](/docs/reference/api/configurations/). If you created a public
Configuration, you don't need to include the `Authorization` request header with a session ID, but
you do need to pass the Configuration object ID as a query parameter.

## Response `200`

Create a new booking

- object
  - `request_id` string — The request ID.
  - `data` object — The response object.
    - `booking_id` string, required — The unique ID of the booking.
    - `event_id` string, required — The unique ID of the event object associated with the booking.
    - `title` string, required — The title of the event.
    - `organizer` object, required — The participant that is designated as the organizer of the event.
      - `email` string — The organizer's email address.
      - `name` string — The organizer's name.
    - `status` 'booked' | 'pending' | 'cancelled', required — The current status of the booking.
    - `description` string — The description of the event.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Rate Limit
- `504` — Provider Failure

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)