> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetocal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get booking
> Get a booking by SID.
This endpoint is part of API v1, which is deprecated. Please use the [v2 API](/getting-started/introduction) instead.
Replace `{your-subdomain}` with your workspace’s subdomain.
Learn how to find your subdomain in [Workspace subdomain](/getting-started/workspace-subdomain).
## OpenAPI
````yaml bundled-v1/bookings.yaml GET /bookings/{booking_sid}
openapi: 3.0.3
info:
title: NeetoCal Bookings APIs
version: 1.0.0
servers:
- description: NeetoCal APIs
url: https://{your-subdomain}.neetocal.com/api/external/v1
variables:
your-subdomain:
default: spinkart
description: >-
Replace **spinkart** with your [workspace's
subdomain](/getting-started/workspace-subdomain).
security: []
tags:
- name: Bookings
description: APIs to create, list, reschedule, and cancel bookings.
paths:
/bookings/{booking_sid}:
get:
tags:
- Bookings
summary: Get booking details
description: Get a booking by SID.
parameters:
- $ref: '#/components/parameters/api_key_header'
- in: path
name: booking_sid
description: SID of the booking you want to retrieve.
required: true
schema:
type: string
example: 8sqtzrs
responses:
'200':
description: OK - Request succeeded
content:
application/json:
schema:
$ref: '#/components/schemas/booking'
example:
id: efb296a3-8205-419f-8ac4-1abfc46bc3c7
sid: 8sqtzrs
parent_booking_id: null
name: John Doe
email: john.doe@example.com
host_name: Jane Smith
host_email: jane@bigbinary.com
is_multihost: false
multihosts:
- name: Jane Smith
email: jane@bigbinary.com
starts_at: '2025-07-23T05:00:00.000Z'
ends_at: '2025-07-23T05:15:00.000Z'
time_zone: Asia/Kolkata
starts_at_for_client: '2025-07-23T10:30:00.000+05:30'
ends_at_for_client: '2025-07-23T10:45:00.000+05:30'
status: confirmed
cancel_reason: null
cancelled_by: null
reschedule_requested: false
preferred_meeting_spot: jitsi
room_type: jitsi
room_url: https://jitsi.neetocal.com/meeting-with-jane-of-jane-d12ec
room_id: null
spot_details: https://jitsi.neetocal.com/meeting-with-jane-of-jane-d12ec
created_at: '2025-07-22T06:29:35.963Z'
updated_at: '2025-07-22T06:31:33.090Z'
meeting_id: 8a7794e3-3142-4569-9dd7-6411369b5d3f
meeting:
name: Product Demo Meeting
no_show: false
meeting_outcome: null
internal_notes: null
metadata: {}
admin_booking_url: https://jane-bigbinary.neetocal.com/admin/bookings/8sqtzrs
client_booking_url: https://jane-bigbinary.neetocal.com/booking/8sqtzrs
form_responses:
- field: Name
value: John Doe
type: name
field_code: name
Name: John Doe
- field: Email
value: john.doe@example.com
type: email
field_code: email
Email: john.doe@example.com
- field: Guest email(s)
value: []
type: additional_guests
field_code: guest_email_s
Guest email(s): []
form_responses_as_hash:
name: John Doe
email: john.doe@example.com
guest_email_s: []
components:
parameters:
api_key_header:
in: header
name: X-Api-Key
description: >-
Use the X-Api-Key header to provide your workspace API key. Refer to
[Authentication](/getting-started/authentication) for more information.
required: true
schema:
type: string
schemas:
booking:
type: object
properties:
id:
type: string
description: Unique identifier for the booking.
sid:
type: string
description: Short identifier (SID) for the booking, used in URLs and API calls.
parent_booking_id:
type: string
nullable: true
description: Reference to the parent booking if this is a group booking.
email:
type: string
description: Email address of the person who made the booking.
name:
type: string
description: Name of the person who made the booking.
host_name:
type: string
description: Name of the primary host for the meeting.
host_email:
type: string
description: Email address of the primary host for the meeting.
is_multihost:
type: boolean
description: Whether the meeting has multiple hosts.
multihosts:
type: array
items:
type: object
properties:
name:
type: string
description: Name of the host.
email:
type: string
description: Email address of the host.
description: List of all hosts for the meeting when is_multihost is true.
starts_at:
type: string
format: date-time
description: Start time of the booking in UTC.
ends_at:
type: string
format: date-time
description: End time of the booking in UTC.
time_zone:
type: string
description: Time zone of the booking location.
starts_at_for_client:
type: string
description: Start time of the booking in the client's local time zone.
ends_at_for_client:
type: string
description: End time of the booking in the client's local time zone.
status:
type: string
description: >-
Current status of the booking (e.g., confirmed, cancelled,
awaiting_approval, rejected).
cancel_reason:
type: string
nullable: true
description: Reason provided when the booking was cancelled.
cancelled_by:
type: string
nullable: true
description: Name of the person who cancelled the booking.
reschedule_requested:
type: boolean
description: Whether a reschedule has been requested for this booking.
preferred_meeting_spot:
type: string
description: Preferred meeting platform or location type selected by the client.
room_type:
type: string
nullable: true
description: |
Type of meeting room or platform being used.
enum:
- daily
- zoom
- jitsi
- google_meet
- teams
- whereby
- in_person
- custom
- phone_call
room_url:
type: string
nullable: true
description: URL for the meeting room or platform.
room_id:
type: string
nullable: true
description: Unique identifier for the meeting room or platform.
spot_details:
type: string
nullable: true
description: Additional details about the meeting place.
created_at:
type: string
format: date-time
description: Timestamp when the booking was created.
updated_at:
type: string
format: date-time
description: Timestamp when the booking was last updated.
meeting_id:
type: string
description: Unique identifier of the scheduling link this booking belongs to.
meeting:
type: object
properties:
name:
type: string
description: Name of the scheduling link.
description: Basic information about the associated meeting.
no_show:
type: boolean
description: Whether the booking is marked as no-show by the host.
meeting_outcome:
nullable: true
description: Meeting outcome assigned to the booking.
allOf:
- $ref: '#/components/schemas/meeting_outcome'
notes_url:
type: string
nullable: true
description: URL to access notes or additional information about the booking.
internal_notes:
type: string
nullable: true
description: Internal notes about the booking visible only to hosts and admins.
metadata:
type: object
nullable: true
description: Additional custom data associated with the booking.
admin_booking_url:
type: string
description: URL for hosts and admins to view and manage the booking.
client_booking_url:
type: string
description: URL for clients to view their booking details.
form_responses:
type: array
items:
type: object
properties:
field:
type: string
description: Display name of the form field.
value:
type: string
description: Value submitted for the form field.
type:
type: string
description: Type of the form field (e.g., name, email, additional_guests).
field_code:
type: string
description: Internal code identifier for the form field.
description: Responses submitted through the booking form.
form_responses_as_hash:
type: object
description: Form responses organized as key-value pairs for easier access.
additionalProperties:
type: string
payment:
nullable: true
description: >-
Payment details for the booking. Included only when a payment exists
for the booking.
allOf:
- $ref: '#/components/schemas/booking_payment'
meeting_outcome:
type: object
properties:
id:
type: string
description: Unique identifier for the meeting outcome.
example: 59413def-60eb-47c6-b390-098fcf583b66
name:
type: string
description: Name of the meeting outcome.
example: Pricing Discussion
color:
type: string
description: Color assigned to the meeting outcome.
enum:
- blue
- orange
- gray
- red
- yellow
- violet
- pink
- teal
- cyan
- green
example: yellow
kind:
type: string
description: Kind of the meeting outcome.
example: custom
color_hex:
type: string
description: Hex color code for the meeting outcome.
example: '#EAB308'
is_system:
type: boolean
description: >-
Whether this is a system-defined meeting outcome. System outcomes
cannot be modified or deleted.
example: false
is_organization_owned:
type: boolean
description: Whether this outcome belongs to the organization.
example: true
booking_payment:
type: object
description: >
Payment details associated with the booking. Present only when a payment
exists for the booking.
properties:
id:
type: string
format: uuid
description: Unique identifier of the payment record.
example: f46c9ddf-221d-4238-afb2-280c1c6b3185
external_id:
type: string
nullable: true
description: Payment reference ID from the payment provider.
example: pi_3ThCkv2c3CtEndqE1BwejQno
provider:
type: string
description: Payment provider that processed the payment.
example: stripe
amount:
type: string
description: Payment amount.
example: '100.0'
currency:
type: string
description: Currency code. Follows the ISO 4217 standard.
example: USD
status:
type: string
description: Current status of the payment.
example: successful
successful:
type: boolean
description: Whether the payment was completed successfully.
example: true
payment_at:
type: string
format: date-time
nullable: true
description: Timestamp when the payment was made.
example: '2026-06-11T17:51:09.321Z'
````