# List bookings

> Returns meetings booked through the agent, paginated — both natively scheduled meetings on your connected Google Calendar and Cal.com bookings, each carrying its provider, start and end time, attendee timezone, and status.

Source: https://www.hey.support/docs/api/bookings/list-bookings

---

<ApiEndpoint method="GET" path="/bookings" />

Read-only: bookings are created by visitors in the widget.

## Query parameters

<TypeTable
  type={{
  "chatbot_id": { type: "string", description: "Sqid-encoded chatbot id. Scopes results to one chatbot.", required: false },
  "since": { type: "string (date-time)", description: "", required: false },
  "limit": { type: "integer", description: "", required: false },
  "offset": { type: "integer", description: "", required: false }
}}
/>

## Response `200`

Returns a `data` array with a `pagination` object. Each item:

<TypeTable
  type={{
  "id": { type: "string (uuid)", description: "Booking UUID (not sqid-encoded)", required: true },
  "chatbot_id": { type: "string", description: "", required: true },
  "conversation_id": { type: "string", description: "", required: false },
  "name": { type: "string", description: "", required: false },
  "email": { type: "string (email)", description: "", required: false },
  "event_label": { type: "string", description: "", required: false },
  "provider": { type: "string", description: "", required: false },
  "external_uid": { type: "string", description: "Provider booking uid (Cal.com) — null on legacy rows.", required: false },
  "start_at": { type: "string (date-time)", description: "", required: false },
  "end_at": { type: "string (date-time)", description: "", required: false },
  "attendee_timezone": { type: "string", description: "", required: false },
  "status": { type: "string", description: "", required: true },
  "created_at": { type: "string (date-time)", description: "", required: true }
}}
/>

### Errors

* `401` — Missing or invalid API key
* `429` — Rate limit exceeded

Every error shares [one envelope](/docs/api/errors).

## Example

```bash
curl https://www.hey.support/api/v1/bookings \
  -H 'Authorization: Bearer hs_live_…'
```