---
title: "Retrieve a booking"
method: GET
path: "/bookings/{bookingId}"
tags: ["bookings"]
---

# Retrieve a booking

`GET /bookings/{bookingId}`

## Request

- Base URL: `https://agentbookable.com`
- URL: `https://agentbookable.com/bookings/{bookingId}`
- Auth: none declared

Live status of a booking by its AgentBookable id (`bb_bkg_*`). Customer personal data is partially masked.

## Path parameters

- `bookingId` string, required

## Response `200`

The booking

- Booking
  - `id` string
  - `businessId` string
  - `serviceId` string
  - `staffId` string, nullable
  - `start` string
  - `end` string
  - `status` 'confirmed' | 'pending' | 'cancelled' | 'completed'
  - `customer` object: Personal data partially masked
    - `name` string
    - `email` string, nullable
    - `phone` string, nullable
  - `createdVia` 'agent'
  - `mandateRef` string
  - `createdAt` string
  - `updatedAt` string

## Other responses

- `404`: Booking not found
- `429`: Too many requests — slow down

---

[API](https://skmtc.dev/agentbookable/apis/agentbookable-booking-api-for-ai-agents.md) · [All operations](https://skmtc.dev/agentbookable/apis/agentbookable-booking-api-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentbookable/apis/agentbookable-booking-api-for-ai-agents/revisions/736963f5951a?raw)