> ## Documentation Index > Fetch the complete documentation index at: https://docs.slng.ai/llms.txt > Use this file to discover all available pages before exploring further. # List batch jobs > Returns a paginated list of jobs for your organization. Supports filtering by status, model, and submission date range, plus sorting. ## OpenAPI ````yaml /api-reference/batch/batch.oas.json get /v1/batch/jobs openapi: 3.1.0 info: version: 0.1.0 title: SLNG Batch API description: >- Transcribe audio files asynchronously. Upload a file, monitor the job progress, and download the transcript when it's ready. servers: - url: https://api.batch.slng.ai description: Production - url: https://stageapi.batch.slng.ai description: Staging security: - bearerAuth: [] tags: - name: Speechmatics description: Create and manage asynchronous transcription jobs. paths: /v1/batch/jobs: get: tags: - Speechmatics summary: List batch jobs description: >- Returns a paginated list of jobs for your organization. Supports filtering by status, model, and submission date range, plus sorting. operationId: batchJobsList parameters: - name: page in: query schema: type: integer minimum: 1 default: 1 description: Page number (1-based). - name: page_size in: query schema: type: integer minimum: 1 maximum: 100 default: 20 description: Number of items per page. - name: status in: query schema: type: string description: >- Comma-separated statuses to filter by. Allowed values: `QUEUED`, `IN_PROGRESS`, `DECODING`, `DONE`, `FAILED`, `DELETED`. example: DONE,FAILED - name: model_code in: query schema: type: string description: Filter by model code (exact match). example: slng/speechmatics/batch:15.0.0 - name: submitted_after in: query schema: type: string format: date-time description: Filter jobs submitted after this ISO 8601 datetime. example: '2026-04-01T00:00:00Z' - name: submitted_before in: query schema: type: string format: date-time description: Filter jobs submitted before this ISO 8601 datetime. example: '2026-04-30T23:59:59Z' - name: sort_by in: query schema: type: string enum: - submitted_at - status - model_code default: submitted_at description: Field to sort results by. - name: sort_order in: query schema: type: string enum: - asc - desc default: desc description: Sort direction. responses: '200': description: Paginated job list. Each item follows the `BatchJob` schema. content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/BatchJob' meta: type: object description: Pagination envelope. properties: page: type: integer page_size: type: integer total: type: integer pages: type: integer example: items: - job_id: myjob123 status: DONE model_code: slng/speechmatics/batch:15.0.0 submitted_at: '2026-04-01T12:00:00Z' - job_id: myjob456 status: IN_PROGRESS model_code: slng/speechmatics/batch:15.0.0 submitted_at: '2026-04-02T09:30:00Z' meta: page: 1 page_size: 20 total: 142 pages: 8 '400': description: >- Validation error (invalid status, sort field, sort order, or datetime format). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: >- Invalid status value(s): BOGUS. Allowed: DECODING, DELETED, DONE, FAILED, IN_PROGRESS, QUEUED '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/InternalError' components: schemas: BatchJob: type: object description: A batch transcription job. required: - job_id - status properties: job_id: type: string description: Alphanumeric job identifier. api_key_id: type: string description: >- API key that submitted the job. May differ from the API key used to call this endpoint when the job was created via the dashboard. organisation_id: type: string format: uuid description: Organisation that owns the job. model_code: type: string description: Model used (e.g. `slng/speechmatics/batch:15.0.0`). status: type: string description: Public-facing job status. enum: - QUEUED - IN_PROGRESS - DECODING - POST_PROCESSING - DONE - FAILED - DELETED job_config: type: object description: >- Full job-config object as submitted (`type`, `transcription_config`, optional `tracking`, `output_config`). additionalProperties: true input_metadata: type: object description: >- Measured input file properties (`size_bytes`, `duration_seconds`, `format`, `mime_type`, `source`). additionalProperties: true output_metadata: type: object description: Measured output properties (populated on completion). additionalProperties: true error_message: type: object nullable: true description: Error envelope for `FAILED` jobs. Otherwise `null`. required: - message additionalProperties: false properties: message: type: string description: User-presentable error string (display verbatim). submitted_at: type: string format: date-time description: When the job was created. started_at: type: string format: date-time nullable: true description: When processing began. completed_at: type: string format: date-time nullable: true description: When the job reached a terminal state. deleted_at: type: string format: date-time nullable: true description: When the job was deleted. expired_at: type: string format: date-time nullable: true description: When the job was expired. updated_at: type: string format: date-time description: Last row update. Error: type: object description: >- Error envelope. A short, user-presentable string only — no internal codes, stack traces, or upstream raw text. required: - error additionalProperties: false properties: error: type: string responses: Forbidden: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: API key id not found InternalError: description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: API key from the SLNG dashboard. ````