> ## Documentation Index > Fetch the complete documentation index at: https://docs.aircaps.com/llms.txt > Use this file to discover all available pages before exploring further. # List transcripts > Your transcripts, newest first. Items omit the result fields (`text`, `speakers`, `utterances`, `words`). ## OpenAPI ````yaml GET /v1/transcripts openapi: 3.1.0 info: title: AirCaps API version: 1.0.0 description: >- Speech-to-text for English. A5S Async v1 (REST) and A5S v2 Streaming (WebSocket). servers: - url: https://api.aircaps.com security: - bearerAuth: [] tags: - name: Transcripts - name: Files - name: Account paths: /v1/transcripts: get: tags: - Transcripts summary: List transcripts description: >- Your transcripts, newest first. Items omit the result fields (`text`, `speakers`, `utterances`, `words`). operationId: listTranscripts parameters: - name: limit in: query description: Number of transcripts to return. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: status in: query description: Only transcripts with this status. schema: type: string enum: - queued - processing - completed - error - name: before in: query description: 'Pagination cursor: the `next_before` of the previous page.' schema: type: string responses: '200': description: A page of transcripts. content: application/json: schema: $ref: '#/components/schemas/TranscriptList' example: object: list data: - id: tr_01k6z3m4q8w7e5r2t1y0u9i8o7 object: transcript status: completed created_at: '2026-10-06T18:01:02.123Z' started_at: '2026-10-06T18:01:02.456Z' completed_at: '2026-10-06T18:01:31.789Z' audio_url: null file_id: file_01k6z3m4q8w7e5r2t1y0u9i8o7 language_code: en model: a5s-async-v1 audio_duration: 3600.512 metadata: meeting_id: 42 webhook_url: https://example.com/hooks/aircaps webhook_status_code: 200 error: null has_more: true next_before: tr_01k6z3m4q8w7e5r2t1y0u9i8o7 '400': description: >- Invalid request. Codes: `invalid_request`, `unsupported_language`, `unsupported_model`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: unsupported_language message: >- language 'de' is not supported; only English ("en", "en-US", ...) is available today. Multilingual support is planned. 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 components: schemas: TranscriptList: type: object required: - object - data - has_more - next_before properties: object: type: string enum: - list data: type: array items: $ref: '#/components/schemas/TranscriptSummary' 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 description: >- Also in the `x-request-id` header. Include it when contacting support. TranscriptSummary: type: object required: - id - object - status - created_at - started_at - completed_at - audio_url - file_id - language_code - model - audio_duration - metadata - webhook_url - webhook_status_code - error description: A transcript without its result fields. properties: id: type: string description: Transcript ID. example: tr_01k6z3m4q8w7e5r2t1y0u9i8o7 object: type: string enum: - transcript example: transcript status: type: string enum: - queued - processing - completed - error description: >- `queued`: waiting for a processing slot. `processing`: being transcribed. `completed`: result fields present. `error`: see `error`. created_at: type: string format: date-time description: When the transcript was created (UTC). started_at: type: - string - 'null' format: date-time description: When processing started. completed_at: type: - string - 'null' format: date-time description: When the job finished (completed or error). audio_url: type: - string - 'null' description: The submitted `audio_url`, if any. file_id: type: - string - 'null' description: The submitted `file_id`, if any. language_code: type: string enum: - en description: Language of the transcript (normalised). model: type: string enum: - a5s-async-v1 audio_duration: type: - number - 'null' description: Audio duration in seconds, once known. example: 3600.512 metadata: type: - object - 'null' description: Your `metadata`, echoed back. webhook_url: type: - string - 'null' description: Webhook target, if any. webhook_status_code: type: - integer - 'null' description: HTTP status of the last webhook delivery. error: oneOf: - $ref: '#/components/schemas/JobError' - type: 'null' description: Set when `status` is `error`. JobError: type: object required: - code - message properties: code: type: string enum: - invalid_audio - audio_too_long - file_too_large - download_failed - file_not_found - usage_limit_reached - internal_error - canceled description: Why the job failed. Failed jobs never count toward usage. message: type: string description: Human-readable detail. 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.