> ## Documentation Index > Fetch the complete documentation index at: https://aircaps.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # List speakers > Your enrolled speakers, newest first, with their enrollments. ## OpenAPI ````yaml GET /v1/speakers openapi: 3.1.0 info: title: AirCaps AI API version: 1.0.0 description: >- Speech-to-text: A5S Async v1 (REST; English, Spanish, French, German, Portuguese, Hindi, Japanese, Korean and Chinese) and A5S Small V2 Streaming (WebSocket; English). Speaker diarization: AirCaps Diarization-v1 (REST). Speaker identification: AirCaps Speaker ID-v1 (REST, synchronous). servers: - url: https://api.aircaps.com security: - bearerAuth: [] tags: - name: Transcripts - name: Diarizations - name: Speakers - name: Files - name: Account paths: /v1/speakers: get: tags: - Speakers summary: List speakers description: Your enrolled speakers, newest first, with their enrollments. operationId: listSpeakers parameters: - name: limit in: query description: Number of speakers to return. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: before in: query description: 'Pagination cursor: the `next_before` of the previous page.' schema: type: string responses: '200': description: A page of speakers. content: application/json: schema: $ref: '#/components/schemas/EnrolledSpeakerList' example: object: list data: - id: spk_01k73a9x8w7v6u5t4s3r2q1p0n object: speaker name: Ana García metadata: employee_id: E-1042 model: aircaps-speaker-id-v1 num_enrollments: 2 enrolled_duration: 27.9 enrollments: - id: enr_01k73b2c4d5e6f7g8h9j0k1m2n object: speaker_enrollment speaker_id: spk_01k73a9x8w7v6u5t4s3r2q1p0n audio_duration: 12.48 consistency: 0.712 created_at: '2026-10-08T18:03:11.402Z' - id: enr_01k73b5f1h2j3k4m5n6p7q8r9s object: speaker_enrollment speaker_id: spk_01k73a9x8w7v6u5t4s3r2q1p0n audio_duration: 15.42 consistency: 0.712 created_at: '2026-10-08T18:04:52.015Z' created_at: '2026-10-08T18:02:40.118Z' updated_at: '2026-10-08T18:04:52.015Z' has_more: false next_before: null '400': description: >- Invalid query parameter (`param` names it). Codes: `invalid_request`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: invalid_request message: Input should be greater than or equal to 10 param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 '401': description: 'Missing or invalid API key. Codes: `unauthorized`.' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication_error code: unauthorized message: invalid API key param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 '403': description: >- The account may not do this. Codes: `account_suspended`, `account_disabled`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: permission_error code: account_disabled message: this account is disabled param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 '500': description: >- Server error. Safe to retry (use the same Idempotency-Key). Codes: `internal_error`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: api_error code: internal_error message: internal error param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 '503': description: >- Temporarily unavailable. Retry after the Retry-After interval. Codes: `service_unavailable`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: api_error code: service_unavailable message: temporarily unavailable; please retry param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer components: schemas: EnrolledSpeakerList: type: object required: - object - data - has_more - next_before properties: object: type: string enum: - list data: type: array items: $ref: '#/components/schemas/EnrolledSpeaker' has_more: type: boolean next_before: type: - string - 'null' description: Pass as `before` for the next page. Error: type: object required: - error properties: error: type: object required: - type - code - message - request_id properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - rate_limit_error - api_error code: type: string description: Machine-readable code; see [Errors](/errors). message: type: string param: type: - string - 'null' description: The request field at fault, if any. request_id: type: - string - 'null' description: >- Also in the `x-request-id` header. Include it when contacting support. `null` on 502/504 from the edge. EnrolledSpeaker: type: object required: - id - object - name - metadata - model - num_enrollments - enrolled_duration - enrollments - created_at - updated_at properties: id: type: string description: Speaker ID. example: spk_01k73a9x8w7v6u5t4s3r2q1p0n object: type: string enum: - speaker name: type: - string - 'null' description: Your label for the speaker. example: Ana García metadata: type: - object - 'null' description: Your `metadata`. example: employee_id: E-1042 model: type: string enum: - aircaps-speaker-id-v1 num_enrollments: type: integer example: 2 enrolled_duration: type: number description: Seconds of enrollment audio in total. example: 27.9 enrollments: type: array items: $ref: '#/components/schemas/SpeakerEnrollment' description: Oldest first. Only embeddings are stored, never the audio. created_at: type: string format: date-time updated_at: type: string format: date-time description: Last change to the name, metadata or enrollments. SpeakerEnrollment: type: object required: - id - object - speaker_id - audio_duration - consistency - created_at properties: id: type: string description: Enrollment ID. example: enr_01k73b2c4d5e6f7g8h9j0k1m2n object: type: string enum: - speaker_enrollment speaker_id: type: string example: spk_01k73a9x8w7v6u5t4s3r2q1p0n audio_duration: type: number description: Seconds of audio in the enrollment clip. example: 12.48 consistency: type: - number - 'null' description: >- How well this enrollment matches the speaker's other enrollments (-1 to 1). `null` when it is the only one. A value much lower than the speaker's other enrollments suggests a clip of someone else or a poor recording. example: 0.712 created_at: type: string format: date-time securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key: `Authorization: Bearer aircaps_sk_...`' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.