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

# Get a booking

`GET /bookings/{booking}`

## Request

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

## Path parameters

- `booking` integer, required

## Response `200`

`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

## Other responses

- `401`: The API key is missing, invalid, expired or revoked.
- `403`: The key does not have the `bookings:read` scope.
- `404`: No record with that id belongs to your account.
- `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)