# Events (/en/docs/api/native/media/events)



Page by seq: asc with after\_seq, desc with before\_seq. Never combine both cursors.

[Guide →](/en/docs/developers/services/media/quickstart)

[Base URL and authentication](/en/docs/api/native/media)

## List events [#list-events]

`GET /media/v1/libraries/{library_id}/events`

| Parameter | Location | Type | Description |
| --- | --- | --- | --- |
| library_id | path | string | Library ID |
| after_seq | query | integer | Ascending cursor; cannot combine with before_seq |
| before_seq | query | integer | Descending cursor; cannot combine with after_seq |
| order | query | asc / desc | asc (default) or desc |
| limit | query | integer | 1–200 items per page, default 50 |

Returns: `MediaEventPage`.

### Response [#response]

#### HTTP 200 [#http-200]

Successful response.

**application/json**

| Name | Type | Description |
| --- | --- | --- |
| data | array<object> | Events in this page, ordered by sequence in the requested direction. |
| data[].seq | number | Increasing sequence number within this library; use it with after_seq or before_seq to page through events. |
| data[].id | string | Unique identifier of this recorded event. |
| data[].type | string | Type of lifecycle, asset, processing, search or batch change recorded. |
| data[].processed_at | string | Time this event was recorded, in UTC. |
| data[].library_id | string | Identifier of the library whose event was recorded. |
| data[].asset_id | string | Related asset identifier, when the event concerns an asset. |
| data[].job_id | string | Related batch job identifier, when present. |
| data[].kind | string | Related processing task: visual, frames, transcript or embedding. |
| data[].detail | object | Event-specific details, such as changed values, reprocessing kinds or failed-item counts. |
| next_cursor | string | null | Last returned sequence as a string when more events exist; convert to a number and pass as after_seq for asc or before_seq for desc. Null means no further page. |

```bash
curl -X GET "https://api.deepraxis.ai/media/v1/libraries/${LIBRARY_ID}/events?limit=1" \
  -H "Authorization: Bearer $PRAXIS_API_KEY"
```

HTTP 200

```json
{
  "data": [
    {
      "seq": 1,
      "id": "2cd2cd71-1fc5-41fc-aeb0-29583af9b900",
      "type": "library.status_provisioning",
      "processed_at": "2026-10-09T09:34:09.858Z",
      "library_id": "lib_fff73e25733449b1bf6f880d91f5c045"
    }
  ],
  "next_cursor": "1"
}
```

## MediaEventPage [#mediaeventpage]

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| data | MediaEvent[] | yes | Results in this page |
| next_cursor | string / null | yes | Next-page cursor; null or absent at the end |

## MediaEvent [#mediaevent]

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| seq | number | yes | Increasing event sequence within the library |
| id | string | yes | Resource ID |
| type | MediaEventType | yes | Resource or event type |
| processed_at | IsoTimestamp | yes | Event timestamp |
| library_id | LibraryId | yes | Library ID |
| asset_id | AssetId | no | Asset ID |
| job_id | JobId | no | Job ID |
| kind | ProcessingKind | no | Understanding or processing kind; filters the understanding list |
| detail | object | no | Event details |