---
title: "Read retained narration inputs, audio identity and paginated word timing"
method: GET
path: "/workspace/media/assets/{assetId}/narration"
tags: ["Media Library"]
---

# Read retained narration inputs, audio identity and paginated word timing

`GET /workspace/media/assets/{assetId}/narration`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/workspace/media/assets/{assetId}/narration`
- Auth: API key in header `Authorization`

Read retained narration inputs, audio identity and paginated word timing.

## Path parameters

- `assetId` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful response

- object
  - `assetId` string, uuid, required
  - `take` object, nullable, required
    - `requestFingerprint` string, required
    - `preparedRequest` object, required
      - `version` 1, required
      - `provider` 'elevenlabs', required
      - `voiceId` string, required
      - `body` object, required
        - `text` string, required
        - `modelId` string, required
        - `outputFormat` 'mp3_44100_128', required
        - `voiceSettings` object, required
          - `stability` number, required
          - `similarityBoost` number, required
        - `applyTextNormalization` 'auto', required
        - `previousText` string
        - `nextText` string
        - `previousRequestIds` string[]
      - `processing` object, required
        - `version` 'ffmpeg-atempo-v1', required
        - `speed` number, required
    - `timingSource` 'provider', required
    - `durationSeconds` number, required
    - `durationSource` 'decoded' | 'legacy-container', required
    - `audio` object, required
      - `sha256` string, required
      - `bytes` integer, required
      - `contentType` 'audio/mpeg', required
      - `analysis` object, nullable, required
        - `version` 1, required
        - `method` 'ffmpeg-astats', required
        - `codec` 'mp3', required
        - `sampleRate` integer, required
        - `channels` integer, required
        - `decodedSamples` integer, required
        - `peakDbfs` number, required
        - `rmsDbfs` number, required
        - `silenceThresholdDbfs` -60, required
  - `wordTimings` object[], required
    - `word` string, required
    - `startSeconds` number, required
    - `endSeconds` number, required
    - `index` integer, required
  - `bounds` object, required
    - `limit` integer, required
    - `offset` integer, required
    - `total` integer, required
    - `returned` integer, required
    - `hasMore` boolean, required
    - `truncated` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)