# transcriptions

Query

Fetch transcriptions for one or more media contents belonging to the current workspace.

Available to agents as MCP tool `getTranscriptions` — see [Read tools](/api/v2/docs/mcp/read-tools#get-transcriptions).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `itemIds` | `[ID!]` | No | — | Filter by item IDs (maximum 1000). |
| `mediaContentIds` | `[ID!]` | No | — | Filter by media content IDs (maximum 20). |

## Returns

Returns [`[Transcription!]!`](/api/v2/docs/types/transcription).

## Examples

### Get transcriptions for items

Fetch transcriptions for the media content of video items.

```graphql
query TranscriptionsDefault($itemIds: [ID!]) {
  transcriptions(itemIds: $itemIds) {
    mediaContentId
    transcript
  }
}
```

Variables:

```json
{
  "itemIds": [
    "99bb982f-563c-5cd7-9475-2798be58f881"
  ]
}
```

Response — HTTP 200:

```json
{
  "data": {
    "transcriptions": [
      {
        "mediaContentId": "2",
        "transcript": "Welcome to Northwind Botanicals — plant care tips, take 1."
      }
    ]
  }
}
```