# List transcriptions

Retrieve a paginated list of transcriptions for the authenticated user's organization, with optional status filtering.

Returns a list of transcriptions belonging to the authenticated user's organization. Results are paginated using `limit` and `offset` parameters. You can filter by transcription status to find only completed, processing, or failed jobs.

Each item in the list includes summary information: transcription ID, status, model used, synapses consumed, audio duration, and timestamps.

#### Query Parameters

**`status`** string optional

Filter by transcription status. One of: `queued`, `processing`, `completed`, `failed`, `cancelled`.

**`limit`** integer optional · Defaults to `20`

Maximum number of transcriptions to return. Must be between 1 and 100.

**`offset`** integer optional · Defaults to `0`

Number of transcriptions to skip for pagination.

## Returns

Returns a success envelope with:

- **`data.transcriptions`** -- Array of transcription summary objects, each containing `transcription_id`, `status`, `model_key`, `synapses_consumed`, `audio_duration_seconds`, `created_at`, and optionally `completed_at`.
- **`data.pagination`** -- Pagination metadata: `total_count`, `returned_count`, `limit`, `has_more`, and `links` (with `first`, `current`, `next`, `previous` URLs).
- **`metadata`** -- Request metadata: `request_id`, `timestamp`, `processing_time_ms`.


Request

```bash cURL
curl -s -X GET "https://api.aitronos.com/v1/audio/transcribe?status=completed&limit=10&offset=0" \
  -H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool
```


```python Python SDK
from aitronos import Aitronos

client = Aitronos(api_key="your-api-key")

result = client.audio.list_transcriptions(
    status="completed",
    limit=10,
    offset=0,
)

for t in result.data.transcriptions:
    print(f"{t.transcription_id}: {t.status} ({t.audio_duration_seconds}s)")
```


```python Python
import requests

url = "https://api.aitronos.com/v1/audio/transcribe"
headers = {"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
params = {"status": "completed", "limit": 10, "offset": 0}

response = requests.get(url, headers=headers, params=params)
data = response.json()

for t in data["data"]["transcriptions"]:
    print(f"{t['transcription_id']}: {t['status']}")

print(f"Has more: {data['data']['pagination']['has_more']}")
```


```javascript JavaScript
const accessToken = process.env.ACCESS_TOKEN;

const params = new URLSearchParams({
  status: 'completed',
  limit: '10',
  offset: '0',
});

const response = await fetch(
  `https://api.aitronos.com/v1/audio/transcribe?${params}`,
  {
    headers: {
      'Authorization': `Bearer ${accessToken}`,
    },
  }
);

const data = await response.json();
data.data.transcriptions.forEach(t => {
  console.log(`${t.transcription_id}: ${t.status}`);
});
```

Response

```json 200 OK
{
  "success": true,
  "data": {
    "transcriptions": [
      {
        "transcription_id": "trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
        "status": "completed",
        "model_key": "fvt-1",
        "synapses_consumed": 126,
        "audio_duration_seconds": 125.5,
        "created_at": "2026-03-02T10:30:00Z",
        "completed_at": "2026-03-02T10:32:15Z"
      },
      {
        "transcription_id": "trans_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
        "status": "completed",
        "model_key": "fvt-1",
        "synapses_consumed": 60,
        "audio_duration_seconds": 59.8,
        "created_at": "2026-03-01T14:00:00Z",
        "completed_at": "2026-03-01T14:01:05Z"
      }
    ],
    "pagination": {
      "total_count": 2,
      "returned_count": 2,
      "limit": 10,
      "has_more": false,
      "links": {
        "first": "https://api.aitronos.com/v1/audio/transcribe?limit=10",
        "current": "https://api.aitronos.com/v1/audio/transcribe?limit=10&offset=0"
      }
    }
  },
  "metadata": {
    "request_id": "req_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d",
    "timestamp": "2026-03-02T12:00:00Z",
    "processing_time_ms": 35
  }
}
```


```json 422 Validation Error
{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "The provided parameter value is invalid.",
    "system_message": "Limit must not exceed 100",
    "type": "validation_error",
    "status": 422,
    "details": {
      "limit": 200,
      "maximum": 100
    },
    "trace_id": "abc-123-def",
    "timestamp": "2026-03-02T12:00:00Z"
  }
}
```

## Related Resources

- [Create Transcription](/docs/api-reference/audio/create-transcription)
- [Get Transcription](/docs/api-reference/audio/get-transcription)
- [Delete Transcription](/docs/api-reference/audio/delete-transcription)
- [Get Paragraphs](/docs/api-reference/audio/get-paragraphs)
- [Get Sentences](/docs/api-reference/audio/get-sentences)
- [Get Subtitles](/docs/api-reference/audio/get-subtitles)
- [Search Transcript](/docs/api-reference/audio/search-transcript)
- [Get Redacted Audio](/docs/api-reference/audio/get-redacted-audio)
- [Upload Audio File](/docs/api-reference/audio/upload-audio)