> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riverside.fm/llms.txt
> Use this file to discover all available pages before exploring further.

# List Edits

> Retrieves a paginated list of edits (clips) for the account, with optional filtering by studio, project, and date range.

**HTTP Method**: GET

**URL**: `/api/v3/edits`

**Authentication**: Requires API Key in the request header.

**Authorization**: Only edits belonging to the account associated with the API token are returned. When `studioId` or `projectId` filters are supplied, the studio/project must belong to the account.

**Query Parameters**:

| Parameter    | Type    | Description                                                                                                 |
| :----------- | :------ | :---------------------------------------------------------------------------------------------------------- |
| `studioId`   | string  | Filter edits by studio ID                                                                                   |
| `projectId`  | string  | Filter edits by project ID                                                                                  |
| `start_date` | string  | Only return edits created on or after this date (ISO-8601). Example: `2025-10-01T00:00:00Z`                 |
| `end_date`   | string  | Only return edits created on or before this date (ISO-8601). Must be greater than or equal to `start_date`. |
| `page`       | integer | Page number (starts from 1)                                                                                 |

**Response**: Paginated list of edit objects for the account.

**Rate limit**: Once every 1 second for unique requests.

**Pagination**: This endpoint uses **page-based pagination** with a fixed page size of 20 edits. To iterate through all results:

1. Make the first request without a `page` parameter (defaults to page 1).
2. If `next_page_url` is not `null`, request the next page (either follow `next_page_url` or increment `page`).
3. Repeat until `next_page_url` is `null`.

**Status Codes**:

* `200 OK` Edits retrieved successfully.
* `401 Unauthorized` Authentication failed (missing or invalid API token).
* `429 Too Many Requests` This endpoint is rate limited.
* `500 Internal Server Error` Unexpected server error.

### **Sample Request**

```bash theme={null}
GET /api/v3/edits HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY
```

### **Sample Request with filters**

```bash theme={null}
GET /api/v3/edits?studioId=640479c9-1222-4161-1234-dee0d855e685&start_date=2025-10-01T00:00:00Z&end_date=2025-10-31T23:59:59Z&page=2 HTTP/1.1
Host: platform.riverside.fm
Authorization: Bearer YOUR_API_KEY
```

### **Sample Response**

```json theme={null}
{
  "page": 1,
  "next_page_url": "https://platform.riverside.fm/api/v3/edits?page=2",
  "total_items": 200,
  "total_pages": 10,
  "data": [
    {
      "clip_id": "6618c2e4f2a9b8001234abcd",
      "name": "Episode 12 – Final",
      "project_id": "6618c2e4f2a9b800123424tt",
      "studio_id": "6618c2e4f2a9b80012342444",
      "created_date": "2025-10-05T12:00:00Z",
      "status": "exported",
      "download_url": "https://platform.riverside.fm/api/v3/download/export/6618c2e4f2a9b8001234abcd"
    },
    {
      "clip_id": "6618c2e4f2a9b80012342460",
      "name": "Episode 11 – Draft",
      "project_id": "6618c2e4f2a9b800123424tt",
      "studio_id": "6618c2e4f2a9b80012342444",
      "created_date": "2025-10-05T12:00:00Z",
      "status": "draft",
      "download_url": null
    }
  ]
}
```