> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/bookings/openapi.json](/docs/api/bookings/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Bookings: List bookings

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

One endpoint of [Bookings](/docs/api/bookings.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## List bookings

`GET /v1/bookings` - operationId `bookings.list`

| Permission | Rate limit |
| --- | --- |
| Calendar view | 12,000 requests a minute per API key |

Lists the bookings you can see, ordered by start time.

Combine any of these filters: `hostMemberId`, `organizerMemberId`, `status` (`confirmed`,
`rescheduled`, `cancelled` or `no_show`, several separated by commas), `startAfter` (starts at
or after this time), `startBefore` (starts before this time), `campaignId`, `personId` and
`accountId`. A filter only narrows what you can see. Page with `limit`, from 1 to 200 (default 50), and
the `cursor` from `pagination.nextCursor`.

Errors:

- `400 validation_failed`: `status` holds an unknown value, `startBefore` is not after
`startAfter`, `limit` is out of range, or `cursor` is not valid.
- `403 forbidden`: the API key is not tied to a member of the workspace.

Requires Meetings view.

Needs the `scheduler` feature on your workspace. Until it is on, calls answer 404.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/bookings/GET/v1/bookings)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | integer (int32) | no | Number of bookings per page, from 1 to 200. Default 50. |
| `cursor` | query | string | no | The `nextCursor` from the previous page. Omit it for the first page. |
| `hostMemberId` | query | integer (int64) | no | Only bookings this member hosts, by member id. |
| `organizerMemberId` | query | integer (int64) | no | Only bookings this member organizes, by member id. It never shows a booking you could not see without it. |
| `status` | query | string | no | Only bookings in these statuses, as a comma-separated list of `confirmed`, `rescheduled`, `cancelled` and `no_show`. Omitted returns every status. |
| `startAfter` | query | string (date-time) | no | Only bookings that start at or after this time, an ISO 8601 timestamp. |
| `startBefore` | query | string (date-time) | no | Only bookings that start before this time, an ISO 8601 timestamp. With `startAfter`, it must be later than `startAfter`. |
| `campaignId` | query | integer (int64) | no | Only bookings credited to this campaign. |
| `personId` | query | integer (int64) | no | Only bookings linked to this person, by the booking's `personId`. |
| `accountId` | query | integer (int64) | no | Only bookings linked to this account, by the booking's `accountId`. |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions. |
| `X-Ken-Workspace-Id` | header | integer (int64) | no | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`. |

### Response 200

`data` is a list of `Booking`. Each item has these fields. The response also carries `pagination`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer (int64) | The booking's id. |
| `status` | string | The booking's status: `confirmed` (it holds the host's time), `rescheduled` (a newer booking replaced it), `cancelled` or `no_show`. |
| `meetingTypeId` | integer (int64) | The meeting type that was booked. |
| `hostMemberId` | integer (int64) | The member who hosts the meeting. |
| `organizerMemberId` | integer (int64) | The member who organizes the meeting, usually the host. |
| `startAt` | string (date-time) | When the meeting starts (UTC). |
| `endAt` | string (date-time) | When the meeting ends (UTC). |
| `bookerTimeZone` | string | The booker's time zone, like `America/New_York`; null when the page did not send one. |
| `booker` | BookingBooker | The person who booked. |
| `bookerPhone` | string | The number the booker gave for a phone meeting, which the host calls; null for other kinds. |
| `locationKind` | string | The location the booker picked or got: `video`, `phone`, `in_person`, `custom`, `google_meet`, `microsoft_teams`, `zoom` or `webex`. Null on bookings made before Kenso stored it: those follow the meeting type's location. |
| `locationDetail` | string | That location's address, link or instructions as the host set it; null when it has none, for a phone call (see `bookerPhone`), and on bookings made before Kenso stored it. |
| `answers` | map of object | The booker's answers, keyed by question id: a string, or a list of strings for a `multiple_choice` question. |
| `personId` | integer (int64) | The person in the workspace who booked; null when Kenso has not matched one. |
| `accountId` | integer (int64) | The account the booking belongs to; null when there is none. |
| `meetingId` | integer (int64) | The meeting on the host's calendar, once Kenso has linked it. |
| `source` | string | Where the booking came from: `personal`, `campaign`, `reply`, `studio` or `single_use`. |
| `campaignId` | integer (int64) | The campaign the booking came from; null when it did not come from one. |
| `stepOrder` | integer (int32) | The campaign step the booking came from; null when it did not come from one. |
| `touchId` | integer (int64) | The touch the booking came from. Always null for now. |
| `assetId` | integer (int64) | The asset the booking came from; null when it did not come from one. |
| `bookingLinkId` | integer (int64) | The booking link the booker used; null when they used the booking page directly. |
| `routingReason` | string | Why this host got the booking, for your members only; the booker never sees it. |
| `provider` | string | The host's calendar: `google` or `microsoft`. |
| `calendarEmail` | string | The host's calendar mailbox the event was written to; null when the calendar did not say. |
| `cancelReason` | string | Why the booking was cancelled; null when it was not, or no reason was given. |
| `cancelledAt` | string (date-time) | When the booking was cancelled (UTC); null when it was not. |
| `rescheduledFromBookingId` | integer (int64) | The booking this one replaced when the booker rescheduled; null otherwise. |
| `createdAt` | string (date-time) | When the booking was made (UTC). |
| `updatedAt` | string (date-time) | When the booking last changed (UTC). |

### Request

```bash
curl -X GET "https://api.ken.so/v1/bookings?limit=50" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"
```

### Example response

```json
{
  "success": true,
  "data": [
    {
      "id": 812,
      "status": "string",
      "meetingTypeId": 812,
      "hostMemberId": 812,
      "organizerMemberId": 812,
      "startAt": "2026-09-23T15:02:11Z",
      "endAt": "2026-09-23T15:02:11Z",
      "bookerTimeZone": "America/New_York",
      "booker": {
        "name": "string",
        "email": "jane@example.com",
        "company": "string"
      },
      "bookerPhone": "string",
      "locationKind": "video",
      "locationDetail": "string",
      "answers": {
        "key": null
      },
      "personId": 812,
      "accountId": 812,
      "meetingId": 812,
      "source": "personal",
      "campaignId": 812,
      "stepOrder": 1,
      "touchId": 812,
      "assetId": 812,
      "bookingLinkId": 812,
      "routingReason": "string",
      "provider": "google",
      "calendarEmail": "jane@example.com",
      "cancelReason": "string",
      "cancelledAt": "2026-09-23T15:02:11Z",
      "rescheduledFromBookingId": 812,
      "createdAt": "2026-09-23T15:02:11Z",
      "updatedAt": "2026-09-23T15:02:11Z"
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6ODE1fQ",
    "hasMore": true,
    "total": 1,
    "totalCount": 1,
    "isTotalCapped": true
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### BookingBooker

The person who booked.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | no | The booker's name. |
| `email` | string | no | The booker's email address, in lowercase. |
| `company` | string | no | The booker's answer to the Company question; null when they gave none. |
