# List bookings

`GET https://app.whatsetter.com/api/v1/bookings`

Calls booked by the AI in chat, most recent slot first. Requires scope
`bookings:read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `status` | query | booked \| canceled \| rescheduled \| failed \| no_show | no | Exact match on the booking status. |
| `campaign_id` | query | string | no | Filter by campaign. Accepts the campaign's `campaign_id` slug or its document `id` (both returned by `GET /campaigns`). |
| `since` | query | string | no | Only bookings starting after this ISO-8601 date. |
| `limit` | query | integer | no |  |
| `cursor` | query | string | no | Opaque cursor from the previous page's `pagination.next_cursor`. |

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/bookings' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: Page of bookings

```json
{
  "data": [
    {
      "id": "",
      "status": "booked",
      "lead_id": "",
      "campaign_id": "",
      "provider": "",
      "source": "chat",
      "start_at": "",
      "end_at": "",
      "timezone": "",
      "attendee": {
        "name": "",
        "email": "",
        "phone": ""
      },
      "cancel_url": "",
      "reschedule_url": "",
      "canceled_at": "",
      "cancellation_reason": "",
      "created_at": ""
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": ""
  }
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 422: Invalid parameter or body (also an invalid or expired `cursor`)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/listbookings/
