List Event Type Available Times | Calendly

import { CalendlyClient } from "calendly";
async function main() {
    const client = new CalendlyClient({
        token: "YOUR_TOKEN_HERE",
    });
    await client.eventTypes.listEventTypeAvailableTimes({
        endTime: "2020-01-08T00:00:00.000000Z",
        eventType: "https://api.calendly.com/event_types/AAAAAAAAAAAAAAAA",
        startTime: "2020-01-02T20:00:00.000000Z",
    });
}
main();

{
  "collection": [
    {
      "status": "available",
      "invitees_remaining": 2,
      "start_time": "2020-01-02T20:00:00.000000Z",
      "scheduling_url": "https://calendly.com/acmesales/discovery-call/2020-01-02T20:00:00Z?month=2020-01&date=2020-01-02"
    },
    {
      "status": "available",
      "invitees_remaining": 1,
      "start_time": "2020-01-03T15:00:00.000000Z",
      "scheduling_url": "https://calendly.com/acmesales/discovery-call/2020-01-03T15:00:00Z?month=2020-01&date=2020-01-03"
    },
    {
      "status": "available",
      "invitees_remaining": 3,
      "start_time": "2020-01-07T23:00:00.000000Z",
      "scheduling_url": "https://calendly.com/acmesales/discovery-call/2020-01-07T23:00:00Z?month=2020-01&date=2020-01-07"
    }
  ]
}

Returns a list of available times for an event type within a specified date range.

NOTE:

Date range can be no greater than 31 days.
This endpoint does not support traditional keyset pagination.

Required scopes

availability:read

Returns a list of available times for an event type within a specified date range. **NOTE:** * Date range can be no greater than 31 days. * This endpoint does not support traditional keyset pagination. <Info title="Required scopes"> > `availability:read` </Info>

Authentication

AuthorizationBearer

OAuth 2.0

AuthorizationBearer

Personal Access Token

Query parameters

event_typestringRequiredformat: "uri"

The uri associated with the event type

start_timestringRequiredformat: "date-time"

Start time of the requested availability range. Date cannot be in the past.

end_timestringRequiredformat: "date-time"

End time of the requested availability range. Date must be in the future and no greater than 31 days from start_time.

Response

collectionlist of objects

The set of available times for the event type matching the criteria

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error