Available slots

Overview

The "Available slots" API allows users to retrieve a list of available times of the user (or users in the case of multi-host or round-robin meetings) for a specific meeting for a given month. These slots can later be used to book a meeting.

Usage

Base URL

https://<workspace>.neetocal.com/api/external/v1

Replace the <workspace> with your workspace subdomain.

Endpoint

GET /slots/<meeting_slug>

Replace the <meeting_slug> with your meeting's slug.

Request header

This endpoint requires authentication. You must include a valid API key in the request header.

Header

Type

Required

Description

X-Api-Key

String

Yes

Bearer token for API access.

Query parameters

Parameter

Type

Required

Description

time_zone

String

Yes

The time zone in which to check available slots

year

String

Yes

The year for which to check available slots

month

String

Yes

The month for which to check available slots

Note: All the above query parameters can also be passed as a JSON body.

Example

For getting the slots of a meeting, "Meeting with Oliver Smith", with the slug meeting-with-oliver-smith of workspace "Spinkart" with subdomain spinkart using curl:

curl -X GET "https://spinkart.neetocal.com/api/external/v1/slots/meeting-with-oliver-smith?time_zone=America/New_York&year=2024&month=7" \
  --header "X-Api-Key: YOUR_API_KEY"

OR

curl -X GET "https://spinkart.neetocal.com/api/external/v1/slots/meeting-with-oliver-smith" \
--header "X-Api-Key: YOUR_API_KEY" \
--get --data "time_zone=America/New_York" --data "year=2024" --data "month=7"

Response Codes

Code

Description

200

OK - Request succeeded

400

Bad Request - Missing/Invalid parameters

401

Unauthorized - Invalid API key

500

Internal server error

Can't find what you're looking for?