GET

List Schedules


Deprecated

This method has been replaced with Query Schedules, and will be removed on June 30, 2025.

Lists schedules by schedule IDs or schedule owner IDs.

Permissions This endpoint requires the Read Bookings Calendar or the Manage Bookings permission scope. With the Read Bookings Calendar permission scope, the schedule participants are not returned.

Endpoint
GET
https://www.wixapis.com/bookings/v1/calendar/schedules

Query Params
scheduleIdsArray <string>

List by schedule IDs.


scheduleOwnerIdsArray <string>

List by schedule owner IDs.


dontIncludeScheduleParticipantsboolean

Whether to return a list of the schedule's participants.


userIdsArray <string>

List schedules assigned to the given Wix user ids. Requires the Manage Personal Calendar or the Manage Business Calendar scope.

Response Object
schedulesArray <Schedule>

Schedule.

List Schedules

Returns all the schedules in the site

Request
cURL
curl 'https://www.wixapis.com/bookings/v1/calendar/schedules' \ -H 'Authorization: <AUTH>'
Response
JSON
{ "schedules": [ { "id": "03d67e9c-5ba9-4e73-ad9e-7fddc57c6c4e", "scheduleOwnerId": "9b33d0b6-bcd2-408b-ac9d-f164504a16e2", "firstSessionStart": "2019-08-19T11:00:00Z", "lastSessionEnd": "2019-08-26T12:00:00Z", "timeZone": "America/Denver", "intervals": [ { "id": "41f2f68b-9543-42b2-911b-cd98e5463ec1", "start": "2019-08-18T21:00:00Z", "end": "2019-08-26T20:59:59.999Z", "interval": { "daysOfWeek": "MON", "hourOfDay": 14, "minuteOfHour": 0, "duration": 60 }, "frequency": { "repetition": 1 }, "affectedSchedules": [ { "scheduleId": "dc9585a4-a613-46fc-a229-59923efe08c6", "transparency": "BUSY", "scheduleOwnerId": "5460647f-ff8f-45f7-8311-a3aef2d8e9e8" } ] } ], "title": "Intermediate Ski Lesson (members only)", "tags": [ "GROUP" ], "location": { "locationType": "OWNER_BUSINESS" }, "capacity": 50, "rate": { "labeledPriceOptions": {
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?