List bookings

curl --request GET \
  --url https://{your-subdomain}.neetocal.com/api/external/v2/bookings \
  --header 'X-Api-Key: <x-api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};

fetch('https://{your-subdomain}.neetocal.com/api/external/v2/bookings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetocal.com/api/external/v2/bookings"

headers = {"X-Api-Key": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "bookings": [
    {
      "id": "<string>",
      "sid": "<string>",
      "parent_booking_id": "<string>",
      "email": "<string>",
      "name": "<string>",
      "host_name": "<string>",
      "host_email": "<string>",
      "is_multihost": true,
      "multihosts": [
        {
          "name": "<string>",
          "email": "<string>"
        }
      ],
      "starts_at": "2023-11-07T05:31:56Z",
      "ends_at": "2023-11-07T05:31:56Z",
      "time_zone": "<string>",
      "starts_at_for_client": "<string>",
      "ends_at_for_client": "<string>",
      "status": "<string>",
      "cancel_reason": "<string>",
      "cancelled_by": "<string>",
      "reschedule_requested": true,
      "preferred_meeting_spot": "<string>",
      "room_url": "<string>",
      "room_id": "<string>",
      "spot_details": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "meeting_id": "<string>",
      "meeting": {
        "name": "<string>"
      },
      "no_show": true,
      "meeting_outcome": {
        "id": "59413def-60eb-47c6-b390-098fcf583b66",
        "name": "Pricing Discussion",
        "color": "yellow",
        "kind": "custom",
        "color_hex": "#EAB308",
        "is_system": false,
        "is_organization_owned": true
      },
      "notes_url": "<string>",
      "internal_notes": "<string>",
      "metadata": {},
      "admin_booking_url": "<string>",
      "client_booking_url": "<string>",
      "form_responses": [
        {
          "field": "<string>",
          "value": "<string>",
          "type": "<string>",
          "field_code": "<string>"
        }
      ],
      "form_responses_as_hash": {},
      "payment": {
        "id": "f46c9ddf-221d-4238-afb2-280c1c6b3185",
        "external_id": "pi_3ThCkv2c3CtEndqE1BwejQno",
        "provider": "stripe",
        "amount": "100.0",
        "currency": "USD",
        "status": "successful",
        "successful": true,
        "payment_at": "2026-06-11T17:51:09.321Z"
      }
    }
  ],
  "pagination": {
    "total_records": 123,
    "total_pages": 123,
    "current_page_number": 123,
    "page_size": 123
  }
}

GET

bookings

List bookings

curl --request GET \
  --url https://{your-subdomain}.neetocal.com/api/external/v2/bookings \
  --header 'X-Api-Key: <x-api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<x-api-key>'}};

fetch('https://{your-subdomain}.neetocal.com/api/external/v2/bookings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetocal.com/api/external/v2/bookings"

headers = {"X-Api-Key": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "bookings": [
    {
      "id": "<string>",
      "sid": "<string>",
      "parent_booking_id": "<string>",
      "email": "<string>",
      "name": "<string>",
      "host_name": "<string>",
      "host_email": "<string>",
      "is_multihost": true,
      "multihosts": [
        {
          "name": "<string>",
          "email": "<string>"
        }
      ],
      "starts_at": "2023-11-07T05:31:56Z",
      "ends_at": "2023-11-07T05:31:56Z",
      "time_zone": "<string>",
      "starts_at_for_client": "<string>",
      "ends_at_for_client": "<string>",
      "status": "<string>",
      "cancel_reason": "<string>",
      "cancelled_by": "<string>",
      "reschedule_requested": true,
      "preferred_meeting_spot": "<string>",
      "room_url": "<string>",
      "room_id": "<string>",
      "spot_details": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "meeting_id": "<string>",
      "meeting": {
        "name": "<string>"
      },
      "no_show": true,
      "meeting_outcome": {
        "id": "59413def-60eb-47c6-b390-098fcf583b66",
        "name": "Pricing Discussion",
        "color": "yellow",
        "kind": "custom",
        "color_hex": "#EAB308",
        "is_system": false,
        "is_organization_owned": true
      },
      "notes_url": "<string>",
      "internal_notes": "<string>",
      "metadata": {},
      "admin_booking_url": "<string>",
      "client_booking_url": "<string>",
      "form_responses": [
        {
          "field": "<string>",
          "value": "<string>",
          "type": "<string>",
          "field_code": "<string>"
        }
      ],
      "form_responses_as_hash": {},
      "payment": {
        "id": "f46c9ddf-221d-4238-afb2-280c1c6b3185",
        "external_id": "pi_3ThCkv2c3CtEndqE1BwejQno",
        "provider": "stripe",
        "amount": "100.0",
        "currency": "USD",
        "status": "successful",
        "successful": true,
        "payment_at": "2026-06-11T17:51:09.321Z"
      }
    }
  ],
  "pagination": {
    "total_records": 123,
    "total_pages": 123,
    "current_page_number": 123,
    "page_size": 123
  }
}

Replace {your-subdomain} with your workspace’s subdomain.
Learn how to find your subdomain in Workspace subdomain.

Headers

X-Api-Key

string

required

Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.

Query Parameters

type

string

To get the bookings of a particular type only. The available types are upcoming, past, cancelled, and incomplete. If no value is passed it will default to all bookings.

page_number

integer

Retrieve paginated results by specifying the desired page number. If this parameter is absent, all results will be returned.

page_size

integer

Set the number of results returned in the response. Defaulting to 30 when omitted.

host_email

string

To get the bookings of a particular host only.

client_email

string

To get the bookings of a particular client only.

parent_booking_id

string

To get bookings associated with a parent booking, including recurring bookings created alongside the primary booking.

filters

object

Apply filters on your bookings.

Hide child attributes

filters.starts_at

object

To filter bookings by meeting start time, use deep object style in the query string, e.g.: ?filters[starts_at][rule]=after&filters[starts_at][value]=2027-12-19T06:00:00.000Z

Supported rules: at, after, before, between
Value: a single UTC datetime string for at/after/before, or two comma-separated UTC datetime strings for between.

Hide child attributes

filters.starts_at.rule

enum<string>

The rule to be used for comparing with the starts_at value

Available options:

at,

after,

before,

between

filters.starts_at.value

string

filters.ends_at

object

To filter bookings by meeting end time, use deep object style in the query string, e.g.: ?filters[ends_at][rule]=before&filters[ends_at][value]=2027-12-19T10:00:00.000Z

Supported rules: at, after, before, between
Value: a single UTC datetime string for at/after/before, or two comma-separated UTC datetime strings for between.

Hide child attributes

filters.ends_at.rule

enum<string>

The rule to be used for comparing with the ends_at value

Available options:

at,

after,

before,

between

filters.ends_at.value

string

filters.starts_at_for_host

object

To filter bookings by meeting start time in the host's timezone, use deep object style in the query string, e.g.: ?host_email=host@example.com&filters[starts_at_for_host][rule]=on&filters[starts_at_for_host][value]=2025-08-11T10:00:00.000+05:30

Required: This filter only works when host_email parameter is provided
Supported rules: on, after, before, between
Value: accepts both date (YYYY-MM-DD) and datetime strings in host's timezone. For precise filtering, use datetime format with timezone offset.
For between rule: use two comma-separated values
The filter uses the host's timezone for date comparison

Hide child attributes

filters.starts_at_for_host.rule

enum<string>

The rule to be used for comparing with the starts_at_for_host value

Available options:

on,

after,

before,

between

filters.starts_at_for_host.value

string

sorting_order

enum<string>

Sort bookings by booking creation date. The default value is desc.

Available options:

asc,

desc

Response

200 - application/json

OK - Request succeeded

bookings

object[]

List of bookings.

Hide child attributes

bookings.id

string

Unique identifier for the booking.

bookings.sid

string

Short identifier (SID) for the booking, used in URLs and API calls.

bookings.parent_booking_id

string | null

Reference to the parent booking if this is a group booking.

bookings.email

string

Email address of the person who made the booking.

bookings.name

string

Name of the person who made the booking.

bookings.host_name

string

Name of the primary host for the meeting.

bookings.host_email

string

Email address of the primary host for the meeting.

bookings.is_multihost

boolean

Whether the meeting has multiple hosts.

bookings.multihosts

object[]

List of all hosts for the meeting when is_multihost is true.

Hide child attributes

bookings.multihosts.name

string

Name of the host.

bookings.multihosts.email

string

Email address of the host.

bookings.starts_at

string<date-time>

Start time of the booking in UTC.

bookings.ends_at

string<date-time>

End time of the booking in UTC.

bookings.time_zone

string

Time zone of the booking location.

bookings.starts_at_for_client

string

Start time of the booking in the client's local time zone.

bookings.ends_at_for_client

string

End time of the booking in the client's local time zone.

bookings.status

string

Current status of the booking (e.g., confirmed, cancelled, awaiting_approval, rejected).

bookings.cancel_reason

string | null

Reason provided when the booking was cancelled.

bookings.cancelled_by

string | null

Name of the person who cancelled the booking.

bookings.reschedule_requested

boolean

Whether a reschedule has been requested for this booking.

bookings.preferred_meeting_spot

string

Preferred meeting platform or location type selected by the client.

bookings.room_type

enum<string> | null

Type of meeting room or platform being used.

Available options:

daily,

zoom,

jitsi,

google_meet,

teams,

whereby,

in_person,

custom,

phone_call

bookings.room_url

string | null

URL for the meeting room or platform.

bookings.room_id

string | null

Unique identifier for the meeting room or platform.

bookings.spot_details

string | null

Additional details about the meeting place.

bookings.created_at

string<date-time>

Timestamp when the booking was created.

bookings.updated_at

string<date-time>

Timestamp when the booking was last updated.

bookings.meeting_id

string

Unique identifier of the scheduling link this booking belongs to.

bookings.meeting

object

Basic information about the associated meeting.

Hide child attributes

bookings.meeting.name

string

Name of the scheduling link.

bookings.no_show

boolean

Whether the booking is marked as no-show by the host.

bookings.meeting_outcome

object | null

Meeting outcome assigned to the booking.

Hide child attributes

bookings.meeting_outcome.id

string

Unique identifier for the meeting outcome.

Example:

"59413def-60eb-47c6-b390-098fcf583b66"

bookings.meeting_outcome.name

string

Name of the meeting outcome.

Example:

"Pricing Discussion"

bookings.meeting_outcome.color

enum<string>

Color assigned to the meeting outcome.

Available options:

blue,

orange,

gray,

red,

yellow,

violet,

pink,

teal,

cyan,

green

Example:

"yellow"

bookings.meeting_outcome.kind

string

Kind of the meeting outcome.

Example:

"custom"

bookings.meeting_outcome.color_hex

string

Hex color code for the meeting outcome.

Example:

"#EAB308"

bookings.meeting_outcome.is_system

boolean

Whether this is a system-defined meeting outcome. System outcomes cannot be modified or deleted.

Example:

false

bookings.meeting_outcome.is_organization_owned

boolean

Whether this outcome belongs to the organization.

Example:

true

bookings.notes_url

string | null

URL to access notes or additional information about the booking.

bookings.internal_notes

string | null

Internal notes about the booking visible only to hosts and admins.

bookings.metadata

object | null

Additional custom data associated with the booking.

bookings.admin_booking_url

string

URL for hosts and admins to view and manage the booking.

bookings.client_booking_url

string

URL for clients to view their booking details.

bookings.form_responses

object[]

Responses submitted through the booking form.

Hide child attributes

bookings.form_responses.field

string

Display name of the form field.

bookings.form_responses.value

string

Value submitted for the form field.

bookings.form_responses.type

string

Type of the form field (e.g., name, email, additional_guests).

bookings.form_responses.field_code

string

Internal code identifier for the form field.

bookings.form_responses_as_hash

object

Form responses organized as key-value pairs for easier access.

Hide child attributes

bookings.form_responses_as_hash.{key}

string

bookings.payment

object | null

Payment details for the booking. Included only when a payment exists for the booking.

Hide child attributes

bookings.payment.id

string<uuid>

Unique identifier of the payment record.

Example:

"f46c9ddf-221d-4238-afb2-280c1c6b3185"

bookings.payment.external_id

string | null

Payment reference ID from the payment provider.

Example:

"pi_3ThCkv2c3CtEndqE1BwejQno"

bookings.payment.provider

string

Payment provider that processed the payment.

Example:

"stripe"

bookings.payment.amount

string

Payment amount.

Example:

"100.0"

bookings.payment.currency

string

Currency code. Follows the ISO 4217 standard.

Example:

"USD"

bookings.payment.status

string

Current status of the payment.

Example:

"successful"

bookings.payment.successful

boolean

Whether the payment was completed successfully.

Example:

true

bookings.payment.payment_at

string<date-time> | null

Timestamp when the payment was made.

Example:

"2026-06-11T17:51:09.321Z"

pagination

object

Hide child attributes

pagination.total_records

integer

Total number of records.

pagination.total_pages

integer

Total number of pages available.

pagination.current_page_number

integer

Current page number.

pagination.page_size

integer

Number of records per page.

Delete meeting duration Get booking

Getting Started

Scheduling links

Meeting places

Meeting durations

Bookings

Availabilities

Slots

Packages

Team Members

Meeting Outcomes

Discount Codes

Automation Rules

API v1 (Deprecated)

List bookings

Headers

Query Parameters

Response