---
title: "List bookings"
method: GET
path: "/bookings"
tags: ["Bookings"]
---

# List bookings

`GET /bookings`

## Request

- Base URL: `https://vocenya.com/api/public/v1`
- URL: `https://vocenya.com/api/public/v1/bookings`
- Auth: HTTP bearer

Appointments the AI booked, most recently booked first. Filter by appointment time.

## Query parameters

- `starts_after` string, date-time
- `starts_before` string, date-time
- `phone_number` string
- `per_page` integer
- `cursor` string, nullable

## Response `200`

Paginated set of `BookingResource`

- object
  - `data` BookingResource[], required
    - `id` integer, required
    - `livemode` boolean, required: `true` for live data, `false` for test data (created with a `vk_test_` key).
    - `provider` 'google_calendar' | 'microsoft_calendar' | 'jobber' | 'housecall_pro' | 'servicetitan' | 'acuity' | 'hubspot' | 'salesforce' | 'calendly' | 'calcom' | 'slack' | 'notion' | 'google_business_profile' | 'shopify', required: The calendars, scheduling tools, field-service software and CRMs a client can connect for booking and lead sync, the workspace apps (Slack, Notion) that receive the client's events, and the Google Business Profile the receptionist's knowledge is kept in step with, and the Shopify store whose orders, products and policies it answers about.
    - `external_reference` string, nullable, required: The appointment's id in that calendar or software.
    - `starts_at` string, required
    - `duration_minutes` integer, required
    - `name` string, nullable, required
    - `phone_number` string, nullable, required
    - `call_id` integer, nullable, required
    - `outbound_call_id` integer, nullable, required
    - `created_at` string, nullable, required
  - `links` object, required
    - `first` string, nullable, required
    - `last` string, nullable, required
    - `prev` string, nullable, required
    - `next` string, nullable, required
  - `meta` object, required
    - `path` string, nullable, required: Base path for paginator generated URLs.
    - `per_page` integer, required: Number of items shown per page.
    - `next_cursor` string, nullable, required: The "cursor" that points to the next set of items.
    - `prev_cursor` string, nullable, required: The "cursor" that points to the previous set of items.

## Other responses

- `401`: The API key is missing, invalid, expired or revoked.
- `403`: The key does not have the `bookings:read` scope.
- `422`: Validation error
- `429`: Too many requests for this key. Wait for the `Retry-After` seconds.

---

[API](https://skmtc.dev/vocenya/apis/vocenya-api.md) · [All operations](https://skmtc.dev/vocenya/apis/vocenya-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vocenya/apis/vocenya-api/revisions/946913941565?raw)