Scheduling links
Meeting places
Meeting durations
Bookings
Availabilities
Team Members
Meeting Outcomes
Discount Codes
API v1 (Deprecated)
- GETList scheduling links
- GETList scheduling link templates
- GETGet scheduling link
- POSTCreate scheduling link
- PATCHUpdate scheduling link
- POSTCreate one-time scheduling link
- GETList meeting places
- GETGet meeting place
- POSTCreate meeting place
- PUTUpdate meeting place
- DELDelete meeting place
- GETList meeting durations
- GETGet meeting duration
- POSTCreate meeting duration
- PUTUpdate meeting duration
- DELDelete meeting duration
- GETList bookings
- GETGet booking
- POSTCreate booking
- POSTCreate payment
- PUTConfirm payment
- PATCHReschedule booking
- POSTCancel booking
- POSTApprove booking
- POSTReject booking
- GETGet associated bookings
- GETList availabilities of team members
- GETList availabilities of a team member
- GETGet availability
- POSTCreate availability
- PATCHUpdate availability
- POSTCreate custom availability for scheduling-link
- POSTUpdate scheduling-link availability
- GETList available slots
- GETList packages
- GETGet package
- GETList package purchases
- GETGet package purchase
- GETList team members
- POSTAdd team members
- PATCHUpdate team member
- DELRemove team member
- POSTCreate discount code
- POSTCreate automation rule
curl --request GET \
--url https://{your-subdomain}.neetocal.com/api/external/v1/bookings \
--header 'X-Api-Key: <x-api-key>'{
"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": {}
}
],
"pagination": {
"total_records": 123,
"total_pages": 123,
"current_page_number": 123,
"page_size": 123
}
}List bookings
List bookings in the workspace. Supports filtering by client email, host email, booking type, and meeting start/end time.
curl --request GET \
--url https://{your-subdomain}.neetocal.com/api/external/v1/bookings \
--header 'X-Api-Key: <x-api-key>'{
"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": {}
}
],
"pagination": {
"total_records": 123,
"total_pages": 123,
"current_page_number": 123,
"page_size": 123
}
}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.
{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.
Query Parameters
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.
Retrieve paginated results by specifying the desired page number. If this parameter is absent, all results will be returned.
Set the number of results returned in the response. Defaulting to 30 when omitted.
To get the bookings of a particular host only.
To get the bookings of a particular client only.
Apply filters on your bookings.
Hide child attributes
Hide child attributes
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.
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.
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_emailparameter 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
Sort bookings by booking creation date. The default value is desc.
asc, desc Response
OK - Request succeeded
List of bookings.
Hide child attributes
Hide child attributes
Unique identifier for the booking.
Short identifier (SID) for the booking, used in URLs and API calls.
Reference to the parent booking if this is a group booking.
Email address of the person who made the booking.
Name of the person who made the booking.
Name of the primary host for the meeting.
Email address of the primary host for the meeting.
Whether the meeting has multiple hosts.
Start time of the booking in UTC.
End time of the booking in UTC.
Time zone of the booking location.
Start time of the booking in the client's local time zone.
End time of the booking in the client's local time zone.
Current status of the booking (e.g., confirmed, cancelled, awaiting_approval, rejected).
Reason provided when the booking was cancelled.
Name of the person who cancelled the booking.
Whether a reschedule has been requested for this booking.
Preferred meeting platform or location type selected by the client.
Type of meeting room or platform being used.
daily, zoom, jitsi, google_meet, teams, whereby, in_person, custom, phone_call URL for the meeting room or platform.
Unique identifier for the meeting room or platform.
Additional details about the meeting place.
Timestamp when the booking was created.
Timestamp when the booking was last updated.
Unique identifier of the scheduling link this booking belongs to.
Whether the booking is marked as no-show by the host.
Meeting outcome assigned to the booking.
Hide child attributes
Hide child attributes
Unique identifier for the meeting outcome.
"59413def-60eb-47c6-b390-098fcf583b66"
Name of the meeting outcome.
"Pricing Discussion"
Color assigned to the meeting outcome.
blue, orange, gray, red, yellow, violet, pink, teal, cyan, green "yellow"
Kind of the meeting outcome.
"custom"
Hex color code for the meeting outcome.
"#EAB308"
Whether this is a system-defined meeting outcome. System outcomes cannot be modified or deleted.
false
Whether this outcome belongs to the organization.
true
URL to access notes or additional information about the booking.
Internal notes about the booking visible only to hosts and admins.
Additional custom data associated with the booking.
URL for hosts and admins to view and manage the booking.
URL for clients to view their booking details.
Responses submitted through the booking form.
Hide child attributes
Hide child attributes
Display name of the form field.
Value submitted for the form field.
Type of the form field (e.g., name, email, additional_guests).
Internal code identifier for the form field.