curl --request GET \
--url https://api.1club.ai/v1/platform/classes \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.1club.ai/v1/platform/classes"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.1club.ai/v1/platform/classes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.1club.ai/v1/platform/classes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.1club.ai/v1/platform/classes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.1club.ai/v1/platform/classes")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.1club.ai/v1/platform/classes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 123,
"name": "<string>",
"slug": "<string>",
"description": "<string>",
"images": [
"<string>"
],
"classTypeId": 123,
"classType": {
"id": 123,
"name": "<string>",
"slug": "<string>",
"maxPartySize": 123
},
"clubId": 123,
"club": {
"id": 123,
"name": "<string>",
"slug": "<string>"
},
"areaId": 123,
"area": {
"id": 123,
"name": "<string>"
},
"startTime": "2023-11-07T05:31:56Z",
"endTime": "2023-11-07T05:31:56Z",
"durationMinutes": 123,
"isMultiDay": true,
"status": "active",
"visibility": "Public",
"sport": "<string>",
"color": "<string>",
"price": 123,
"priceBeforeTax": 123,
"isFree": true,
"maxCapacity": 123,
"maxPartySize": 123,
"bookedCount": 123,
"currentBookings": 123,
"spotsLeft": 123,
"waitlistCount": 123,
"allowWaitlist": true,
"timeStatus": "past",
"availabilityStatus": "available",
"recurrenceId": 123,
"occurrenceIndex": 123,
"recurrence": {
"id": 123,
"frequency": "daily",
"interval": 123,
"daysOfWeek": [
"<string>"
],
"endsType": "until",
"endsDate": "2023-11-07T05:31:56Z",
"endsTotalOccurrences": 123,
"status": "active"
},
"instructors": [
{
"id": 123,
"contactId": 123,
"sports": [
"<string>"
],
"typeId": 123,
"type": {
"id": 123,
"name": "<string>"
},
"experience": "<string>",
"hourlyRate": 123,
"bio": {},
"certifications": [
"<string>"
],
"isActive": true,
"isBookable": true,
"contact": {
"name": "<string>",
"profileImage": "<string>"
}
}
],
"externalSource": "<string>",
"externalId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"translations": {}
}
],
"total": 123,
"limit": 123,
"offset": 123
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}List classes
Returns the organization’s class occurrences, ordered by start time. One row is one occurrence - a weekly class materializes a row per session, linked by recurrenceId and occurrenceIndex - so a row’s id is what a booking’s classId points at.
The window is open by default: with neither bound the whole schedule is in scope, past included, because this endpoint serves operators reconciling what happened rather than members shopping for a slot. startDate keeps occurrences still running at or after it, endDate keeps occurrences starting before it (exclusive), and each accepts an ISO date-time or a bare YYYY-MM-DD read as midnight UTC. Overlap, not containment, so a long or multi-day class shows up on every day it covers.
Page with limit/offset against the total the response reports. Ordering is stable (startTime, then id).
Every class the organization owns is in scope - member-only and private occurrences included, and those at a deactivated club - because the key holder is the operator, not a visitor. locale resolves name and description; the full translations blob is returned either way.
curl --request GET \
--url https://api.1club.ai/v1/platform/classes \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.1club.ai/v1/platform/classes"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.1club.ai/v1/platform/classes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.1club.ai/v1/platform/classes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.1club.ai/v1/platform/classes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.1club.ai/v1/platform/classes")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.1club.ai/v1/platform/classes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 123,
"name": "<string>",
"slug": "<string>",
"description": "<string>",
"images": [
"<string>"
],
"classTypeId": 123,
"classType": {
"id": 123,
"name": "<string>",
"slug": "<string>",
"maxPartySize": 123
},
"clubId": 123,
"club": {
"id": 123,
"name": "<string>",
"slug": "<string>"
},
"areaId": 123,
"area": {
"id": 123,
"name": "<string>"
},
"startTime": "2023-11-07T05:31:56Z",
"endTime": "2023-11-07T05:31:56Z",
"durationMinutes": 123,
"isMultiDay": true,
"status": "active",
"visibility": "Public",
"sport": "<string>",
"color": "<string>",
"price": 123,
"priceBeforeTax": 123,
"isFree": true,
"maxCapacity": 123,
"maxPartySize": 123,
"bookedCount": 123,
"currentBookings": 123,
"spotsLeft": 123,
"waitlistCount": 123,
"allowWaitlist": true,
"timeStatus": "past",
"availabilityStatus": "available",
"recurrenceId": 123,
"occurrenceIndex": 123,
"recurrence": {
"id": 123,
"frequency": "daily",
"interval": 123,
"daysOfWeek": [
"<string>"
],
"endsType": "until",
"endsDate": "2023-11-07T05:31:56Z",
"endsTotalOccurrences": 123,
"status": "active"
},
"instructors": [
{
"id": 123,
"contactId": 123,
"sports": [
"<string>"
],
"typeId": 123,
"type": {
"id": 123,
"name": "<string>"
},
"experience": "<string>",
"hourlyRate": 123,
"bio": {},
"certifications": [
"<string>"
],
"isActive": true,
"isBookable": true,
"contact": {
"name": "<string>",
"profileImage": "<string>"
}
}
],
"externalSource": "<string>",
"externalId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"translations": {}
}
],
"total": 123,
"limit": 123,
"offset": 123
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.
Query Parameters
Keep occurrences ending after this instant. ISO date-time or YYYY-MM-DD. Omit for no lower bound.
Keep occurrences starting before this instant (exclusive). ISO date-time or YYYY-MM-DD. Omit for no upper bound.
Only classes at this club
Only classes of this class type
Only classes this instructor is assigned to teach
Only classes with this status. A cancelled occurrence keeps its bookings.
active, cancelled Only classes for this sport
Case-insensitive match on the class name
Locale for translated fields (e.g. "en", "es")
Maximum number of classes to return
1 <= x <= 100Number of classes to skip
x >= 0Was this page helpful?