> ## Documentation Index > Fetch the complete documentation index at: https://docs.1club.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get a class by ID > Returns a single class. The class must belong to the organization associated with the API token. Requires the `classes:read` scope. ## OpenAPI ````yaml /openapi-platform.json get /v1/platform/classes/{id} openapi: 3.0.0 info: title: 1Club Platform API version: 1.0.0 description: >- The 1Club Platform API lets you programmatically access and manage your organization's data. ## 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 - all responses are scoped to your org's data. ## Rate Limiting - **100 requests per minute** per organization - 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 | Status | Meaning | |--------|---------| | `400` | Invalid request parameters | | `401` | Missing or invalid API key | | `403` | API key is missing the required scope | | `404` | Resource not found (or doesn't belong to your organization) | | `429` | Rate limit exceeded | | `500` | Internal server error | contact: name: 1Club API Support email: support@1club.ai servers: - url: https://api.1club.ai description: Production API security: - customerApiAuth: [] tags: - name: Classes description: Browse class schedules, pricing, and availability. - name: Content description: Read published content (FAQs, posts, documents, blocks). - name: Clubs description: Look up club details by slug. - name: Transactions description: List and inspect billing transactions. - name: Bookings - name: Areas paths: /v1/platform/classes/{id}: get: tags: - Classes summary: Get a class by ID description: > Returns a single class. The class must belong to the organization associated with the API token. Requires the `classes:read` scope. parameters: - in: path name: id required: true schema: type: integer description: Class ID - in: query name: locale schema: type: string description: Locale for translations responses: '200': description: Class details content: application/json: schema: $ref: '#/components/schemas/PlatformClass' '400': description: Invalid class ID content: application/json: schema: $ref: '#/components/schemas/PlatformError' '401': description: Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/PlatformError' '403': description: API key is missing the required `classes:read` scope content: application/json: schema: $ref: '#/components/schemas/PlatformError' '404': description: Class not found content: application/json: schema: $ref: '#/components/schemas/PlatformError' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/PlatformError' security: - customerApiAuth: [] components: schemas: PlatformClass: type: object description: >- A class returned by the platform API, including scheduling, capacity, pricing (with tax), club/area context, instructors, and computed status fields. properties: id: type: integer name: type: string slug: type: string nullable: true description: type: string nullable: true images: type: array items: type: string classType: type: object nullable: true properties: id: type: integer name: type: string nullable: true slug: type: string nullable: true isMultiDay: type: boolean startTime: type: string format: date-time endTime: type: string format: date-time duration: type: number format: float nullable: true description: Duration in hours when present. maxCapacity: type: integer nullable: true price: type: number format: float nullable: true description: Price including any applicable default tax. isFree: type: boolean visibility: type: string enum: - Public - Member_only - Private status: type: string recurrence: type: object nullable: true additionalProperties: true sport: type: string nullable: true color: type: string nullable: true club: type: object nullable: true properties: id: type: integer name: type: string slug: type: string nullable: true area: type: object nullable: true properties: id: type: integer name: type: string instructors: type: array items: $ref: '#/components/schemas/PlatformInstructor' timeStatus: type: string nullable: true availabilityStatus: type: string nullable: true userStatus: type: string nullable: true waitlistPosition: type: integer nullable: true currentBookings: type: integer nullable: true translations: type: object nullable: true additionalProperties: true description: Per-locale translations keyed by language code (e.g. 'es', 'fr'). PlatformError: type: object properties: error: type: string PlatformInstructor: type: object description: Public instructor shape returned alongside classes. properties: id: type: integer contactId: type: integer sports: type: array items: type: string typeId: type: integer nullable: true type: type: object nullable: true properties: id: type: integer name: type: string experience: type: string nullable: true hourlyRate: type: number format: float nullable: true bio: type: object nullable: true additionalProperties: true description: EditorJS document for the instructor bio. certifications: type: array items: type: string isActive: type: boolean isBookable: type: boolean contact: type: object nullable: true properties: name: type: string nullable: true profileImage: type: string nullable: true securitySchemes: customerApiAuth: type: http scheme: bearer description: Customer API key obtained from the admin portal (e.g. 1club_sk_live_...) ````