## Get lip sync request

`lipsync.requests.retrieve(strid)  -> LipsyncRequest`

**get** `/v1/lipsync/requests/{id}`

Returns a single lip sync request by request UUID or `reference_id`.

### Parameters

- `id: str`

### Returns

- `class LipsyncRequest: …`

  - `id: str`

    Lip sync request ID.

  - `created_at: datetime`

    Request creation time in UTC.

  - `status: str`

    Current request status.

  - `error_message: Optional[str]`

    Failure message when status is `failed`.

  - `finished_at: Optional[datetime]`

    Request processing completion time in UTC.

  - `output_url: Optional[str]`

    URL to the generated output media, when available.

  - `reference_id: Optional[str]`

    Client-provided identifier for this request.

  - `started_at: Optional[datetime]`

    Request processing start time in UTC.

### Example

```python
import os
from chamelaion import Chamelaion

client = Chamelaion(
    api_key=os.environ.get("CHAMELAION_API_KEY"),  # This is the default and can be omitted
)
lipsync_request = client.lipsync.requests.retrieve(
    "6f82a2d8-a6d4-4e8a-a0fa-e8b09823a2d8",
)
print(lipsync_request.id)
```

#### Response

```json
{
  "id": "6f82a2d8-a6d4-4e8a-a0fa-e8b09823a2d8",
  "reference_id": "dub-episode-42",
  "status": "completed",
  "created_at": "2026-04-07T10:00:00Z",
  "started_at": "2026-04-07T10:00:05Z",
  "finished_at": "2026-04-07T10:01:30Z",
  "output_url": "https://storage.chamelaion.com/output/6f82a2d8.mp4"
}
```