> ## Documentation Index > Fetch the complete documentation index at: https://docs.zenamu.com/llms.txt > Use this file to discover all available pages before exploring further. # List lecturers > Returns the lecturers of your studio, so you can resolve the `lecturerIds` returned by the classes and workshops endpoints into names, photos, and biographies. Contact details are never returned. Internal Zenamu system accounts are filtered out. See the [Lecturer](/api/objects/lecturer) object for details. ## OpenAPI ````yaml /api/v1/openapi.yaml get /v1/lecturers openapi: 3.0.3 info: title: Zenamu API v1 version: '1.0' description: The Zenamu public REST API. servers: - url: https://api.zenamu.com description: Production security: - zenamuPublicKey: [] tags: - name: Classes - name: Workshops - name: Lecturers - name: Places - name: Clients - name: Credits and passes - name: Pass groups paths: /v1/lecturers: get: tags: - Lecturers summary: List lecturers description: | Returns the lecturers of your studio, so you can resolve the `lecturerIds` returned by the classes and workshops endpoints into names, photos, and biographies. Contact details are never returned. Internal Zenamu system accounts are filtered out. See the [Lecturer](/api/objects/lecturer) object for details. operationId: getLecturers parameters: - name: includeInactive in: query schema: type: string enum: - 'true' description: >- Set to `true` to also return lecturers who are no longer active. Useful when resolving IDs on past events. Only the exact string `true` enables it. responses: '200': description: The studio's lecturers. headers: X-RateLimit-Limit: description: Maximum requests allowed in the current one-minute window. schema: type: integer example: 100 X-RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer minimum: 0 example: 99 X-RateLimit-Reset: description: Unix timestamp in seconds when the current window resets. schema: type: integer example: 1788336000 content: application/json: schema: $ref: '#/components/schemas/LecturerList' example: statusCode: 200 message: Success data: - _id: a05e73c81df946b20c3ea8175f6b4e92 name: Jane Smith photo: https://storage.zenamu.com/photos/jane-smith.jpg bio: Certified yoga lecturer with ten years of experience. isVisible: true isActive: true - _id: 7c6a2e05d93f18b4ae50c72f1bd8a394 name: Sarah Johnson photo: null bio: Meditation and mindfulness coach. isVisible: false isActive: false '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/KeyNotFound' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' security: - zenamuPublicKey: [] components: schemas: LecturerList: type: object properties: statusCode: type: integer example: 200 message: type: string example: Success data: type: array items: $ref: '#/components/schemas/Lecturer' Lecturer: type: object properties: _id: type: string description: Opaque lecturer ID, as referenced by `lecturerIds`. example: a05e73c81df946b20c3ea8175f6b4e92 name: type: string nullable: true photo: type: string nullable: true description: Portrait URL. The studio-level photo wins over the personal one. bio: type: string nullable: true description: Biography. The studio-level text wins over the personal one. isVisible: type: boolean description: Whether the studio shows this lecturer in public listings. isActive: type: boolean description: >- Whether the lecturer is currently active. Inactive lecturers appear only with `includeInactive=true`. ErrorResponse: type: object required: - statusCode - message properties: statusCode: type: integer description: Repeats the HTTP status code. error: type: string description: >- Short label — `Internal Server Error` for `500`, `Too Many Requests` for `429`, `Error` otherwise. message: type: string description: >- Human-readable explanation. For `500` this is a fixed generic message; the detail is logged server-side. responses: Unauthorized: description: No API key was sent. headers: X-RateLimit-Limit: description: Maximum requests allowed in the current one-minute window. schema: type: integer example: 100 X-RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer minimum: 0 example: 99 X-RateLimit-Reset: description: Unix timestamp in seconds when the current window resets. schema: type: integer example: 1788336000 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: statusCode: 401 error: Error message: >- Missing access token. You must send your access token in the request header ('Authorization: Bearer YOUR_ACCESS_TOKEN' ) Forbidden: description: >- Your studio's plan does not allow the public API. See [Plans and access](/api#plans-and-access). headers: X-RateLimit-Limit: description: Maximum requests allowed in the current one-minute window. schema: type: integer example: 100 X-RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer minimum: 0 example: 99 X-RateLimit-Reset: description: Unix timestamp in seconds when the current window resets. schema: type: integer example: 1788336000 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: statusCode: 403 error: Error message: The Zenamu public API is not available on the Free tariff. KeyNotFound: description: >- The API key was not recognized. Zenamu answers an unknown key with `404`, not `401` — see [Authentication](/api/authentication#authentication-errors). headers: X-RateLimit-Limit: description: Maximum requests allowed in the current one-minute window. schema: type: integer example: 100 X-RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer minimum: 0 example: 99 X-RateLimit-Reset: description: Unix timestamp in seconds when the current window resets. schema: type: integer example: 1788336000 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: statusCode: 404 error: Error message: API key not found TooManyRequests: description: >- You exceeded 100 calls per minute on this endpoint. See [Rate limits](/api/rate-limits). headers: X-RateLimit-Limit: description: Maximum requests allowed in the current one-minute window. schema: type: integer example: 100 X-RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer minimum: 0 example: 99 X-RateLimit-Reset: description: Unix timestamp in seconds when the current window resets. schema: type: integer example: 1788336000 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: statusCode: 429 error: Too Many Requests message: 'Rate limit exceeded: up to 100 requests per minute per endpoint.' InternalServerError: description: >- Unexpected server error. Retry with backoff if the call is safe to repeat. headers: X-RateLimit-Limit: description: Maximum requests allowed in the current one-minute window. schema: type: integer example: 100 X-RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer minimum: 0 example: 99 X-RateLimit-Reset: description: Unix timestamp in seconds when the current window resets. schema: type: integer example: 1788336000 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: statusCode: 500 error: Internal Server Error message: >- We apologize, but there was an error on our end. If problems persist, please contact us at support@zenamu.com securitySchemes: zenamuPublicKey: type: http scheme: bearer description: >- Your **public API key** (`zen_pub_…`), sent as `Authorization: Bearer `. Browser-safe. See [Authentication](/api/authentication). ````