Skip to main content
The 1Club Platform API lets you programmatically access and manage your organization’s data.

​
Base URL

All API requests are made to: 
https://api.1club.ai

​
Official API contract

This documentation is the official source of truth for the 1Club Platform API. If an integration relies on undocumented endpoints, fields, response shapes, or internal behavior outside this spec, we can’t guarantee backward compatibility. Build against what’s documented here to stay stable as the platform evolves.

​
Authentication

All requests require a customer API key passed as a Bearer token: 
Authorization: Bearer 1club_sk_live_...
Generate API keys from the admin portal under Settings > API Tokens. The key is tied to your organization, and all responses are scoped to your organization’s data.

​
Quick start

Fetch the list of clubs: 
curl https://api.1club.ai/v1/public/clubs \
  -H "Authorization: Bearer 1club_sk_live_..."
Get a specific club by slug: 
curl https://api.1club.ai/v1/public/clubs/my-club-slug \
  -H "Authorization: Bearer 1club_sk_live_..."
Browse class schedules: 
curl "https://api.1club.ai/v1/public/classes?clubId=CLUB_ID&date=2026-03-26" \
  -H "Authorization: Bearer 1club_sk_live_..."

​
Rate limiting

  • 100 requests per minute per API key
  • When exceeded, the API returns 429 Too Many Requests with a Retry-After header
  • Rate limit headers are included in every response:
    • X-RateLimit-Limit — max requests per window
    • X-RateLimit-Remaining — requests remaining
    • X-RateLimit-Reset — seconds until the window resets

​
Errors

StatusMeaning
400Invalid request parameters
401Missing or invalid API key
404Resource not found (or doesn’t belong to your organization)
429Rate limit exceeded
500Internal server error

​
Need help?

Contact us at support@1club.ai for API access questions or integration support.