# Get a prompt (/docs/api/media/prompts/getPrompt)

> For the complete documentation index, see [llms.txt](https://docs.tandemcx.ai/llms.txt). Any page on this site can be fetched as Markdown by appending `.md` to its URL.

`GET /v1/media/prompts/{promptId}`

Get a prompt

## Request

**Base URL:** `https://api.tandemcx.ai`

**Authentication:** `Authorization: Bearer <token>` — A Tandem bearer token. Requests are scoped to the organization the token belongs to; no organization header is required.

### Path parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `promptId` | string | Yes | The prompt's unique ID. |

## Responses

### 200 — The prompt.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | — |
| `organizationId` | string | Yes | — |
| `filename` | string | Yes | — |
| `bucket` | string | Yes | — |
| `key` | string | Yes | — |
| `mimetype` | string | Yes | — |
| `language` | enum: `N/A` \| `EN` \| `ES` \| `FR` \| `DE` \| `IT` \| `PT` \| `JA` \| `ZH` | Yes | Prompt language tag. |
| `friendlyName` | string | No | — |
| `waveform` | object | No | — |
| `waveform.promptId` | string | No | — |
| `waveform.sampleRate` | integer | No | — |
| `waveform.bars` | array of number | No | — |
| `waveform.generatedAt` | string (date-time) | No | — |
| `waveform.status` | enum: `pending` \| `processing` \| `ready` \| `error` | No | — |
| `waveform.fallbackToClient` | boolean | No | — |
| `audio` | object | No | — |
| `audio.durationMilliseconds` | integer | No | — |
| `createdAt` | string (date-time) | No | — |
| `updatedAt` | string (date-time) | No | — |

### 401 — Missing, malformed, or expired bearer token.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | object | No | — |
| `error.code` | string | No | — |
| `error.message` | string | No | — |

### 404 — The resource does not exist.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | object | No | — |
| `error.code` | string | No | — |
| `error.message` | string | No | — |