Skip to main content
GET
List classes and course sessions

Authorizations

Authorization
string
header
required

Your public API key (zen_pub_…), sent as Authorization: Bearer <key>. Browser-safe. See Authentication.

Query Parameters

dateFrom
string<date>
required

Start of the range (inclusive), YYYY-MM-DD, read in the studio's time zone. Must be a real calendar date and no later than dateTo. The range may span at most 366 days, counting both ends. See Dates and time zones.

Example:

"2026-03-01"

dateTo
string<date>
required

End of the range (inclusive), YYYY-MM-DD, read in the studio's time zone. Must be a real calendar date on or after dateFrom, and at most 366 days after it. The whole end day is included.

Example:

"2026-03-31"

placeIds
string

Comma-separated numeric place IDs. Returns only classes held at those places. Pass -1 to include online classes. For a course session the place is the one set on that session, where the studio overrode the course's. See Filtering.

Example:

"1,2,3"

lecturerIds
string

Comma-separated numeric lecturer IDs. Matches the class's main lecturer and any additional lecturer. For a course session with a substitute lecturer, only the substitute matches, because the assignment replaces the course's lecturers for that session. See Filtering.

Example:

"5,10"

labelIds
string

Comma-separated numeric label IDs. Returns classes carrying any of the listed tags.

Example:

"8,12"

limit
integer

Maximum number of records to return. Unset returns every match in the range. See Pagination.

Required range: x >= 1
Example:

50

offset
integer

Number of records to skip. See Pagination.

Required range: x >= 0
Example:

0

includeCapacity
enum<string>
default:false

Set to true or 1 to add the capacity object. Omitted by default because it adds overhead — request it only when you display live availability.

Available options:
true,
false,
1,
0

Response

The matching classes and course sessions.

statusCode
integer
Example:

200

message
string
Example:

"Success"

data
object[]