GoHighLevel Calendars API

Get All Schedules

GET/calendars/schedules/search

GET /calendars/schedules/search List user availability schedule. Retrieve user availability schedules based on various filters including location, calendar, and user. It takes 5 query parameters, requires the calendars.readonly scope and authenticates with a sub-account (location) token.

Request and authentication

Method: GET
Full URL: https://services.leadconnectorhq.com/calendars/schedules/search
Scopes: calendars.readonly
Token type: Sub-account (location) token
Accepted auth: OAuth Access Token, Private Integration Token
API version header: Version: 2021-07-28
Schema verified: 22 June 2026

Query parameters

Appended to the URL as a query string.

Name	Type	Description
`locationId`required	`string`	Example: `IkqiJlXJ7o9h61tCHHod`
`userId`required	`string`	Example: `IkqiJlXJ7o9h61tCHHod`
`calendarId`	`string`	Example: `WvVX9LpvlBO6K506xLbp`
`skip`	`number`	Example: `0`
`limit`	`number`	Example: `50`

Response fields

Top-level fields returned on a successful call.

Name	Type	Description
`schedules`required	`array`	Array of schedules

Example request

Copy-paste ready. Swap YOUR_TOKEN for your access token or Private Integration Token.

curl -X GET 'https://services.leadconnectorhq.com/calendars/schedules/search' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28'

Skip the schema lookup

Hylo gives your AI agent this schema — and the other 52 documented here — without you looking anything up. Ask in plain English; it picks the endpoint, fills the body, and can run the call against your own sub-account.

View pricing Read the setup guide

More calendars endpoints