---
canonical_url: "https://docs.composio.dev/toolkits/speechmatics"
markdown_url: "https://docs.composio.dev/toolkits/speechmatics.md"
product: "platform"
version: null
last_updated: null
---

# Speechmatics

Speechmatics provides asynchronous speech-to-text transcription, job management, transcript retrieval, and usage reporting for audio and video.

- **Category:** audio & speech
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `SPEECHMATICS`
- **Version:** 20261014_00

## Tools

### Create Transcription Job

**Slug:** `SPEECHMATICS_CREATE_TRANSCRIPTION_JOB`

Create an asynchronous Speechmatics transcription job from a publicly fetchable media URL and return its job ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `model` | string | No | Optional transcription model supported for the selected language. |
| `domain` | string | No | Optional transcription domain supported for the language and model. |
| `language` | string | Yes | Speechmatics language code for the audio, such as en. |
| `job_title` | string | No | Optional title stored in the job tracking metadata. |
| `media_url` | string | Yes | Public HTTPS URL that Speechmatics can fetch without authentication. |
| `output_locale` | string | No | Optional locale for transcript spelling and formatting, such as en-US. |
| `enable_entities` | boolean | No | Whether to enable entity recognition in the transcript. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Transcription Job

**Slug:** `SPEECHMATICS_DELETE_TRANSCRIPTION_JOB`

Delete a transcription job and its associated transcript and resources, optionally forcing termination of a running job.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `force` | boolean | No | Terminate and delete a running job; without force, a running job may return 423 Locked. |
| `job_id` | string | Yes | Transcription job ID to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Discover Speech Features

**Slug:** `SPEECHMATICS_DISCOVER_SPEECH_FEATURES`

Return Speechmatics' current Batch languages, locales, domains, translation support, and language-identification capabilities.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transcript

**Slug:** `SPEECHMATICS_GET_TRANSCRIPT`

Retrieve a transcription job's completed transcript as structured JSON v2, plain text, or SRT text.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | string ("json-v2" | "txt" | "srt") | No | Transcript representation: structured json-v2, plain txt, or subtitle srt. |
| `job_id` | string | Yes | Completed transcription job ID. |
| `wait_seconds` | integer | No | Seconds for the API to wait for transcript readiness; 0 returns immediately. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transcription Job

**Slug:** `SPEECHMATICS_GET_TRANSCRIPTION_JOB`

Get a transcription job's status, configuration, duration, and processing errors, optionally waiting briefly for a terminal state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Transcription job ID returned by CREATE_TRANSCRIPTION_JOB or LIST_TRANSCRIPTION_JOBS. |
| `wait_seconds` | integer | No | Seconds for the API to wait for a terminal job state; 0 returns immediately. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Usage

**Slug:** `SPEECHMATICS_GET_USAGE`

Get Batch transcription counts and audio duration aggregated over an optional UTC date range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `since` | string | No | Optional inclusive start date in YYYY-MM-DD format. |
| `until` | string | No | Optional inclusive end date in YYYY-MM-DD format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Transcription Jobs

**Slug:** `SPEECHMATICS_LIST_TRANSCRIPTION_JOBS`

List transcription jobs in the connected US1 project, newest first, with an agent-controlled continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum jobs to return in this page (1-100). |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; do not combine it with created_before. |
| `created_before` | string | No | Optional UTC timestamp boundary for the first page; omit when starting from the newest jobs. |
| `include_deleted` | boolean | No | Include deleted job tombstones when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |