> ## Documentation Index
> Fetch the complete documentation index at: https://docs.particle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# particle_podcast_get_transcription_request

> Free: where your organization's transcription request stands, by request ID or episode.

Read where your organization's transcription request stands. It is free, so it is how to wait for a transcription that [`particle_podcast_request_transcription`](https://docs.particle.pro/mcp/tools/podcasts/podcast-request-transcription) queued. Poll it every minute or so, since transcription usually takes 5 to 10 minutes, and never request the episode again to poll.

Pass `request_id` from the request, or the episode's `episode_slug`. By `episode_slug`, your organization's request answers even after the episode is transcribed. For an episode we hold that your organization never requested, there is no request, and the answer says where its transcript stands.

`state` is one of:

* `queued`: waiting its turn.
* `admitted`: being transcribed.
* `transcribed`: the episode tools serve its transcript. Read it with [`particle_podcast_get_episode`](https://docs.particle.pro/mcp/tools/podcasts/podcast-get-episode) (`include: ["transcript"]`), or search it with [`particle_podcast_find_mentions`](https://docs.particle.pro/mcp/tools/podcasts/podcast-find-mentions) and [`particle_podcast_search_transcripts`](https://docs.particle.pro/mcp/tools/podcasts/podcast-search-transcripts).
* `failed`: it will not be transcribed. `failure_reason` says why, and `refunded_at` says when the charge was returned.

This is the MCP form of [`GET /v1/podcasts/transcription/requests/{id}`](https://docs.particle.pro/api-reference/podcast-transcription/get-a-transcription-request), which is free too.

## Inputs

Pass exactly one.

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `request_id` | string | one of | — | The request's `request_id`, as the request tool returned it. |
| `episode_slug` | string | one of | — | The episode whose request to read. |

## Output

The same `## Transcription request` block as [`particle_podcast_request_transcription`](https://docs.particle.pro/mcp/tools/podcasts/podcast-request-transcription), without `**Billed as:**`. It ends with the next step for the request's state. `output_format: "json"` returns the fields as JSON.

## Errors

| Code | When |
| - | - |
| `not_found` | No such request for your organization, or your organization has not requested the episode. Request it first. |
| `missing_parameter` / `invalid_parameter` | Neither or both of `request_id` and `episode_slug`. |
| `api_key_required` | The connection acts for no organization. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.