# List prompts (/docs/api/media/prompts/listPrompts)

> 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`

List prompts

## 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.

### Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | string | No | 1-based page number (default 1). |
| `limit` | string | No | Page size (default 10). |
| `name` | string | No | Case-insensitive filename/friendly-name filter. |
| `sortBy` | enum: `name` \| `createdAt` \| `updatedAt` | No | — |
| `sortOrder` | enum: `asc` \| `desc` | No | — |
| `language` | enum: `N/A` \| `EN` \| `ES` \| `FR` \| `DE` \| `IT` \| `PT` \| `JA` \| `ZH` | No | — |

## Responses

### 200 — A page of prompts.

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

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

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