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

# List Agents

> List all agents owned by the authenticated user.

## Overview

Returns a paginated list of agents belonging to the authenticated user.

<ParamField query="limit" type="integer">
  Maximum number of agents to return. Default `20`, max `100`.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor from a previous response.
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl https://api.okrapdf.com/v1/agents \
    -H "Authorization: Bearer okra_YOUR_KEY"
  ```
</RequestExample>

### Response (200)

```json theme={null}
{
  "data": [
    {
      "id": "agent_cf3de29f5a384695",
      "name": "invoice-extractor",
      "model": "default",
      "table_id": "tbl_abc123",
      "version": 1,
      "created_at": "2026-04-14T05:30:00Z"
    }
  ],
  "has_more": false
}
```