# List library API

URL: https://neattrim.com/docs/tools/list_library

Lists the user's recent results in their library, newest first, with names, sizes and deletion dates.

Lists the user's recent results in their library, newest first, with names, sizes and deletion dates. Use when the user refers to a file they made earlier, on any device or in another assistant.

Endpoint: `GET /v1/library`

MCP name: `list_library` (Available in MCP sets: core, generate, full, local_cloud)

## What it draws

- Does not draw from the allowance.

## Input

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `cursor` | string | no | Cursor from the previous page. |
| `kind` | string | no | Filter by kind. (one of "result", "original") |

## Output

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | array of object | yes |  |
| `next_cursor` | string or null | yes |  |

Endpoint: `GET /v1/library`

Who can call it: An API key, or an OAuth token for an app.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | string | no |  |
| `limit` | query | integer | no |  |
| `kind` | query | any | no |  |
| `channel` | query | string | no |  |

## Examples

Set NEATTRIM_API_KEY to your key, then copy an example. A tool that draws from your allowance reads an uploaded file: upload a sample file as in the quickstart and set VIDEO_FILE_ID (or AUDIO_FILE_ID, IMAGE_FILE_ID, SUBTITLES_FILE_ID) to its file_id. Any other id in an example, such as JOB_ID, is read from a variable of the same name.

### curl

```bash
curl -X GET "https://api.neattrim.com/v1/library" \
  -H "Authorization: Bearer $NEATTRIM_API_KEY"
```

### TypeScript

```ts
// @neattrim/sdk is not on npm yet: it arrives with the first client release. Use the curl example today.
import { api, Neattrim, unwrap } from "@neattrim/sdk";

const client = new Neattrim({ apiKey: process.env.NEATTRIM_API_KEY });
const result = unwrap(
  await api.listLibrary({
    client: client.client,
  }),
);
console.log(result);
```

### Python

```python
# neattrim is not on PyPI yet: it arrives with the first client release. Use the curl example today.
import os

from neattrim import Neattrim
from neattrim_generated.api.library import list_library

with Neattrim(api_key=os.environ["NEATTRIM_API_KEY"], base_url="https://api.neattrim.com") as client:
    result = list_library.sync(client=client.client)
    print(result)
```

## Response 200

Library

## Errors

- `401`: UNAUTHENTICATED or INACTIVE
- `429`: RATE_LIMITED

## Limits

- Largest upload: Free: 200 MB, Plus: 2 GB, Pro: 4 GB
- Jobs running at once: Free: 2, Plus: 3, Pro: 6
- Requests a minute: Free: 60, Plus: 60, Pro: 60
