---
title: "List Agents"
method: GET
path: "/agents"
tags: ["Agents", "Agent"]
---

# List Agents

`GET /agents`

## Request

- Base URL: `https://developers.chatway.app/api/v1`
- URL: `https://developers.chatway.app/api/v1/agents`
- Auth: API key in header `X-API-KEY`

List the agents available to your API key. Use an agent's data[].id when another operation asks for agent_id. Results are paginated: the default is 20 agents per page, with a maximum of 100.

## Query parameters

- `email` string, email, nullable
- `limit` integer, nullable
- `page` integer, nullable

## Response `200`

Paginated list responses include `data`, `meta.pagination`, and `links`. Use the `page` and `limit` query parameters to walk results. Follow `links.next` until it is `null`, or increment `page` until `current_page >= total_pages`.

| Field | Description |
|---|---|
| `meta.pagination.total` | Total records across all pages |
| `meta.pagination.count` | Records returned on this page |
| `meta.pagination.per_page` | Page size used for this response (matches `limit`) |
| `meta.pagination.current_page` | Current page number (1-based) |
| `meta.pagination.total_pages` | Total number of pages |
| `links.next` | URL for the next page, or `null` on the last page |
| `links.first` / `links.last` | First and last page URLs |

- object
  - `data` object[], required
    - `type` string, required
    - `id` string, required
    - `attributes` object, required
      - `email` string, nullable, required
      - `name` string, nullable, required
      - `status` string, nullable, required
      - `online_status` string, nullable, required
      - `profile_photo_url` string, nullable, required
      - `resized_profile_photo_url` string, nullable, required
      - `role` string, nullable, required
  - `meta` object, required
    - `pagination` object, required
      - `total` integer, required
      - `count` integer, required
      - `per_page` integer, required
      - `current_page` integer, required
      - `total_pages` integer, required
  - `links` object, required
    - `self` string, required
    - `first` string, required
    - `next` string, nullable, required
    - `last` string, required

## Other responses

- `422`: Validation error

---

[API](https://skmtc.dev/chatway/apis/chatway-developer-docs.md) · [All operations](https://skmtc.dev/chatway/apis/chatway-developer-docs/llms.txt) · [OpenAPI document](https://skmtc.dev/chatway/apis/chatway-developer-docs/revisions/ca1a1da291cc?raw)