# List uploads

> Meetings recorded elsewhere and sent here, with how far through processing each one is.

`GET https://api-notetaker.nabrah.ai/ext/v1/uploads`

Requires an API key in the `Authorization` header.

Meetings recorded elsewhere and sent here, with how far through processing each one is.

## Query parameters

- `limit` (integer) Default: `25`.
- `offset` (integer) Default: `0`.

## Responses

- `200` — A page of uploads.
- `401` — No key, an unknown key, or one that has been revoked or has expired.
- `403` — The key is read only, or lacks the reach for this route.
- `404` — No such record — or one that belongs to another account.
- `422` — The body or query failed validation; `details` names the field.
- `429` — Too many requests. `Retry-After` says how long to wait.

### 200 example

```json
{
  "data": {
    "rows": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "runId": "00000000-0000-0000-0000-000000000000",
        "reference": "string",
        "title": "string",
        "kind": "audio",
        "stage": "pending",
        "filename": "string",
        "byteSize": 0,
        "durationMs": 0,
        "startsAt": "2026-01-01T09:00:00.000Z",
        "createdAt": "2026-01-01T09:00:00.000Z",
        "updatedAt": "2026-01-01T09:00:00.000Z",
        "error": "string",
        "hasNotes": true
      }
    ],
    "total": 0,
    "limit": 0,
    "offset": 0
  }
}
```

### 401 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 403 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 404 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 422 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 429 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```