Get scheduling link

Get scheduling link details

curl --request GET \
  --url https://{your-subdomain}.neetocal.com/api/external/v2/meetings/{meeting_sid} \
  --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/meetings/{meeting_sid}', 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/meetings/{meeting_sid}"

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

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

print(response.text)

{
  "id": "<string>",
  "sid": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "kind": "one_on_one",
  "duration": 123,
  "disabled": true,
  "spot": "custom",
  "spot_in_person_location": "<string>",
  "spot_custom_text": "<string>",
  "spot_phone_call_number": "<string>",
  "is_template": true,
  "schedulable_range_type": "number_of_days_into_the_future",
  "schedulable_range_value": "<string>",
  "lead_time": 123,
  "start_time_increment": 123,
  "before_buffer_time": 0,
  "after_buffer_time": 0,
  "created_at": "2025-12-23T05:05:27.037Z",
  "updated_at": "2025-03-31T13:22:19.832Z",
  "deleted_at": null,
  "is_multiple_spots_allowed": true,
  "is_multiple_durations_allowed": true,
  "allow_multiple_add_on_services": true,
  "conditional_pricing_enabled": true,
  "is_email_reminders_enabled": true,
  "is_sms_reminders_enabled": true,
  "organization_id": "<string>",
  "rescheduling_lead_time": 123,
  "cancellation_lead_time": 123,
  "booking_modification_allowed": true,
  "cancellation_too_late_notice": "<string>",
  "cancellation_policy": "<string>",
  "rescheduling_too_late_notice": "<string>",
  "pre_booking_allowed": true,
  "original_price_enabled": true,
  "original_price": 123,
  "locked_time_zone": "America/New_York",
  "fees": [
    {
      "id": "1b217cc5-69b5-4fb1-a13c-c22f9c14e7f9",
      "amount": "120.0",
      "currency": "inr",
      "feeable_id": "aff17ff8-1bf8-4e77-a3c5-2f86104f9a20",
      "feeable_type": "Meeting",
      "payment_provider": "cash",
      "kind": "fixed",
      "min_amount": "120.0",
      "is_default": true,
      "display_amount": "<string>",
      "is_tax_enabled": true,
      "is_tip_enabled": true,
      "is_tax_applicable_on_tip": true,
      "vpas": [
        {}
      ],
      "recipient": {
        "id": "<string>",
        "fee_id": "<string>",
        "accountable": {}
      },
      "amount_in_smallest_currency_unit": 12000
    }
  ],
  "durations_possible": [
    123
  ],
  "durations": [
    {
      "id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
      "duration": 30,
      "is_default": false,
      "created_at": "2025-08-18T07:43:16.775Z",
      "updated_at": "2025-08-18T08:03:58.019Z"
    }
  ],
  "hosts": [
    {
      "name": "Oliver Smith",
      "email": "oliver@example.com"
    }
  ],
  "spots": [
    {
      "id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
      "spot": "jitsi",
      "is_default": false,
      "phone_call_number": null,
      "in_person_location": null,
      "custom_text": null,
      "created_at": "2025-08-18T07:19:28.341Z",
      "updated_at": "2025-08-18T07:35:32.822Z"
    }
  ],
  "add_on_services": [
    {
      "id": "77150ec6-d4f0-4665-98f0-34bda69f7b3a",
      "name": "Sauna",
      "description": "20 minutes in the sauna",
      "duration": 30,
      "position": 1,
      "price": "25.5",
      "currency": "usd",
      "payment_provider": "stripe",
      "created_at": "2026-10-06T18:26:08.033Z",
      "updated_at": "2026-10-06T18:26:08.264Z"
    }
  ]
}

GET

meetings

{meeting_sid}

Get scheduling link details

curl --request GET \
  --url https://{your-subdomain}.neetocal.com/api/external/v2/meetings/{meeting_sid} \
  --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/meetings/{meeting_sid}', 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/meetings/{meeting_sid}"

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

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

print(response.text)

{
  "id": "<string>",
  "sid": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "kind": "one_on_one",
  "duration": 123,
  "disabled": true,
  "spot": "custom",
  "spot_in_person_location": "<string>",
  "spot_custom_text": "<string>",
  "spot_phone_call_number": "<string>",
  "is_template": true,
  "schedulable_range_type": "number_of_days_into_the_future",
  "schedulable_range_value": "<string>",
  "lead_time": 123,
  "start_time_increment": 123,
  "before_buffer_time": 0,
  "after_buffer_time": 0,
  "created_at": "2025-12-23T05:05:27.037Z",
  "updated_at": "2025-03-31T13:22:19.832Z",
  "deleted_at": null,
  "is_multiple_spots_allowed": true,
  "is_multiple_durations_allowed": true,
  "allow_multiple_add_on_services": true,
  "conditional_pricing_enabled": true,
  "is_email_reminders_enabled": true,
  "is_sms_reminders_enabled": true,
  "organization_id": "<string>",
  "rescheduling_lead_time": 123,
  "cancellation_lead_time": 123,
  "booking_modification_allowed": true,
  "cancellation_too_late_notice": "<string>",
  "cancellation_policy": "<string>",
  "rescheduling_too_late_notice": "<string>",
  "pre_booking_allowed": true,
  "original_price_enabled": true,
  "original_price": 123,
  "locked_time_zone": "America/New_York",
  "fees": [
    {
      "id": "1b217cc5-69b5-4fb1-a13c-c22f9c14e7f9",
      "amount": "120.0",
      "currency": "inr",
      "feeable_id": "aff17ff8-1bf8-4e77-a3c5-2f86104f9a20",
      "feeable_type": "Meeting",
      "payment_provider": "cash",
      "kind": "fixed",
      "min_amount": "120.0",
      "is_default": true,
      "display_amount": "<string>",
      "is_tax_enabled": true,
      "is_tip_enabled": true,
      "is_tax_applicable_on_tip": true,
      "vpas": [
        {}
      ],
      "recipient": {
        "id": "<string>",
        "fee_id": "<string>",
        "accountable": {}
      },
      "amount_in_smallest_currency_unit": 12000
    }
  ],
  "durations_possible": [
    123
  ],
  "durations": [
    {
      "id": "4ece6b6b-4b5f-4c15-9122-a85af189198c",
      "duration": 30,
      "is_default": false,
      "created_at": "2025-08-18T07:43:16.775Z",
      "updated_at": "2025-08-18T08:03:58.019Z"
    }
  ],
  "hosts": [
    {
      "name": "Oliver Smith",
      "email": "oliver@example.com"
    }
  ],
  "spots": [
    {
      "id": "bcc90342-9345-4d89-9144-d25d7c7b3521",
      "spot": "jitsi",
      "is_default": false,
      "phone_call_number": null,
      "in_person_location": null,
      "custom_text": null,
      "created_at": "2025-08-18T07:19:28.341Z",
      "updated_at": "2025-08-18T07:35:32.822Z"
    }
  ],
  "add_on_services": [
    {
      "id": "77150ec6-d4f0-4665-98f0-34bda69f7b3a",
      "name": "Sauna",
      "description": "20 minutes in the sauna",
      "duration": 30,
      "position": 1,
      "price": "25.5",
      "currency": "usd",
      "payment_provider": "stripe",
      "created_at": "2026-10-06T18:26:08.033Z",
      "updated_at": "2026-10-06T18:26:08.264Z"
    }
  ]
}

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.

Path Parameters

meeting_sid

string

required

The unique SID of the scheduling link you want to fetch. You can get sid in different ways. Visit the scheduling link page and then click on "Settings" > "Show SID". That will give you sid. The other way you can get sid is by listing scheduling links using our List scheduling links API. Here you will see sid for each scheduling link.

Example:

"vj5pgkh"

Response

200 - application/json

OK - Request succeeded

string

Unique identifier for the scheduling link.

sid

string

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

name

string

Display name of the scheduling link.

slug

string

URL-friendly identifier for the meeting, used in public scheduling links.

description

string

Detailed description of the meeting purpose or agenda.

kind

enum<string>

Type of meeting. one_on_one for individual meetings, round_robin for rotating hosts, multihost for multiple simultaneous hosts, grouped for group sessions.

Available options:

one_on_one,

round_robin,

multihost,

grouped

duration

integer

Duration of the meeting in minutes.

disabled

boolean

Whether the scheduling link is currently disabled and not accepting bookings.

spot

enum<string>

Meeting platform or location type for the scheduled meeting.

Available options:

custom,

jitsi,

google_meet,

daily,

zoom,

whereby,

teams,

phone_call,

in_person

spot_in_person_location

string | null

Physical location details when meeting place is set to in_person.

spot_custom_text

string | null

Custom meeting instructions or details when meeting place is set to custom.

spot_phone_call_number

string | null

Phone number for the meeting when place is set to phone_call.

is_template

boolean

Whether this meeting is a template that can be used to create other meetings.

schedulable_range_type

enum<string>

How the scheduling range is calculated - by days into future, business days, or specific date range.

Available options:

number_of_days_into_the_future,

number_of_business_days_into_the_future,

date_range

schedulable_range_value

string

Value for the scheduling range (e.g., number of days or date range).

lead_time

integer

Minimum advance notice required for booking in minutes.

start_time_increment

integer

Time increment in minutes for available booking slots (e.g., 30 for 30-minute slots).

before_buffer_time

integer

Buffer time in minutes before each meeting to allow for setup, preparation, or travel time. Must be between 0 and 1440 (24 hours).

Required range: 0 <= x <= 1440

Example:

0

after_buffer_time

integer

Buffer time in minutes after each meeting to allow for wrap-up, notes, or preparation for the next meeting. Must be between 0 and 1440 (24 hours).

Required range: 0 <= x <= 1440

Example:

0

created_at

string

Timestamp when the meeting was created.

Example:

"2025-12-23T05:05:27.037Z"

updated_at

string

Timestamp when the meeting was last updated.

Example:

"2025-03-31T13:22:19.832Z"

deleted_at

string | null

Timestamp when the meeting was deleted (soft delete).

Example:

null

is_multiple_spots_allowed

boolean

Whether users can select from multiple meeting places.

is_multiple_durations_allowed

boolean

Whether users can select from multiple meeting duration options.

allow_multiple_add_on_services

boolean

Whether people booking can choose more than one add-on service.

Example:

true

conditional_pricing_enabled

boolean

Whether conditional pricing rules are applied to this meeting.

is_email_reminders_enabled

boolean

Whether email reminders are sent for this meeting.

is_sms_reminders_enabled

boolean

Whether SMS reminders are sent for this meeting.

organization_id

string

Unique identifier of the organization that owns this meeting.

rescheduling_lead_time

integer

Minimum advance notice required for rescheduling in minutes.

cancellation_lead_time

integer

Minimum advance notice required for cancellation in minutes.

booking_modification_allowed

boolean

Whether users are allowed to modify their bookings after creation.

cancellation_too_late_notice

string | null

Custom message shown when cancellation is attempted too late.

cancellation_policy

string | null

Policy text explaining cancellation terms and conditions.

rescheduling_too_late_notice

string | null

Custom message shown when rescheduling is attempted too late.

pre_booking_allowed

boolean

Whether users can book meetings in advance beyond the normal scheduling range.

original_price_enabled

boolean

Whether to show the original price alongside any discounted price.

original_price

number | null

Original price of the meeting before any discounts.

locked_time_zone

string | null

Time zone to lock the scheduling link to. When set, all available times are displayed in this time zone regardless of the booker's location. Must be a valid IANA time zone identifier (e.g., 'America/New_York', 'Europe/London').

Example:

"America/New_York"

fees

object[]

Fees or charges associated with the meeting (scheduling link).

Hide child attributes

fees.id

string

Unique identifier for the fee configuration.

Example:

"1b217cc5-69b5-4fb1-a13c-c22f9c14e7f9"

fees.amount

string

The fee amount as a string to preserve decimal precision.

Example:

"120.0"

fees.currency

string

The currency code for the fee amount. Follows the ISO 4217 standard (e.g., "inr", "usd").

Example:

"inr"

fees.feeable_id

string

ID of the entity this fee is associated with (meeting ID in this case).

Example:

"aff17ff8-1bf8-4e77-a3c5-2f86104f9a20"

fees.feeable_type

string

Type of entity this fee is associated with.

Example:

"Meeting"

fees.payment_provider

enum<string>

Payment service provider used for processing payments.

Available options:

stripe,

razorpay,

cash,

paypal,

dodopayments

Example:

"cash"

fees.kind

string

Type of fee structure (e.g., "fixed", "percentage").

Example:

"fixed"

fees.min_amount

string

Minimum amount that can be charged for this fee.

Example:

"120.0"

fees.is_default

boolean

Indicates whether this is the default fee configuration for the meeting.

fees.display_amount

string | null

Custom display amount for the fee (if different from the actual amount).

fees.is_tax_enabled

boolean

Whether tax calculation is enabled for this fee.

fees.is_tip_enabled

boolean

Whether tipping is enabled for this fee.

fees.is_tax_applicable_on_tip

boolean

Whether taxes are calculated on top of tips.

fees.vpas

object[]

Virtual Payment Addresses for UPI payments (India-specific).

fees.recipient

object

The payment recipient configured for this fee.

Hide child attributes

fees.recipient.id

string

Unique identifier for the recipient.

fees.recipient.fee_id

string

ID of the fee this recipient belongs to.

fees.recipient.accountable

object

The connected payment account that receives the payout.

fees.amount_in_smallest_currency_unit

integer

Fee amount in the smallest currency unit (e.g., paise for INR, cents for USD).

Example:

12000

durations_possible

integer[]

List of available duration options in minutes when multiple durations are allowed.

durations

object[]

Hide child attributes

durations.id

string

Unique identifier for the duration option.

Example:

"4ece6b6b-4b5f-4c15-9122-a85af189198c"

durations.duration

integer

Duration in minutes.

Example:

30

durations.is_default

boolean

Whether this duration is the default option.

Example:

false

durations.created_at

string<date-time>

Timestamp when the duration option was created.

Example:

"2025-08-18T07:43:16.775Z"

durations.updated_at

string<date-time>

Timestamp when the duration option was last updated.

Example:

"2025-08-18T08:03:58.019Z"

hosts

object[]

List of hosts for the scheduling link with their name and email.

Hide child attributes

hosts.name

string

Full name of the host.

Example:

"Oliver Smith"

hosts.email

string

Email address of the host.

Example:

"oliver@example.com"

spots

object[]

Hide child attributes

spots.id

string

Unique identifier for the meeting place option.

Example:

"bcc90342-9345-4d89-9144-d25d7c7b3521"

spots.spot

enum<string>

The place type for the meeting.

Available options:

daily,

zoom,

jitsi,

google_meet,

teams,

whereby,

in_person,

custom,

phone_call

Example:

"jitsi"

spots.is_default

boolean

Whether this meeting place is the default option.

Example:

false

spots.phone_call_number

string | null

Phone number for phone call meeting place. Only populated when place type is "phone_call", otherwise null.

Example:

null

spots.in_person_location

string | null

Location details for in-person meetings. Only populated when place type is "in_person", otherwise null.

Example:

null

spots.custom_text

string | null

Custom text for custom meeting place. Only populated when place type is "custom", otherwise null.

Example:

null

spots.created_at

string<date-time>

Timestamp when the meeting place option was created.

Example:

"2025-08-18T07:19:28.341Z"

spots.updated_at

string<date-time>

Timestamp when the meeting place option was last updated.

Example:

"2025-08-18T07:35:32.822Z"

add_on_services

object[]

Add-on services people can choose when booking, in display order.

Hide child attributes

add_on_services.id

string

Unique identifier for the add-on service.

Example:

"77150ec6-d4f0-4665-98f0-34bda69f7b3a"

add_on_services.name

string

Name of the add-on service shown to the person booking.

Example:

"Sauna"

add_on_services.description

string | null

Description of the add-on service.

Example:

"20 minutes in the sauna"

add_on_services.duration

integer

Minutes the add-on service adds to the booking.

Required range: 0 <= x <= 1440

Example:

30

add_on_services.position

integer

Display order of the add-on service, starting at 1.

Example:

1

add_on_services.price

string | null

Price of the add-on service in the major unit of currency, returned as a decimal string to keep its exact value (the request takes it as a number). null when the add-on service is free.

Example:

"25.5"

add_on_services.currency

string | null

Currency of price, taken from the scheduling link's fee. null when the add-on service is free.

Example:

"usd"

add_on_services.payment_provider

string | null

Payment provider used to collect price, taken from the scheduling link's fee. null when the add-on service is free.

Example:

"stripe"

add_on_services.created_at

string<date-time>

Timestamp when the add-on service was created.

Example:

"2026-10-06T18:26:08.033Z"

add_on_services.updated_at

string<date-time>

Timestamp when the add-on service was last updated.

Example:

"2026-10-06T18:26:08.264Z"

Getting started

Scheduling links

Meeting places

Meeting durations

Add-on services

Calendar preferences

Bookings

Availabilities

Slots

Holidays

Packages

Team members

Meeting outcomes

Blocked emails

Payments

Discount codes

Automation rules

Prefill tokens

API v1 (deprecated)

Headers

Path Parameters

Response