---
title: "Get agents"
method: GET
path: "/api/v2/agents"
tags: ["Agents"]
---

# Get agents

`GET /api/v2/agents`

Returns a paginated list of agents in the organization. Supports filtering by status, manager, custom role, name, and more.

## Query parameters

- `sort` string[]
- `filter` union — Root filter schema for the agents list endpoint — supports filtering by id, status, manager, custom role, name, title, and timestamps.
  - object
    - `$op` 'or' | 'and', required
  - FilterAgent — Filter schema for the agents list endpoint — supports filtering by id, name, title, status, manager, custom role, and timestamps.
    - `manager_id` union — Filter agents by their assigned manager's ID.
      - ManagerId — unresolved $ref
      - object
        - `eq` ManagerId — unresolved $ref
        - `not_eq` ManagerId — unresolved $ref
        - `contains` ManagerId — unresolved $ref
        - `not_contain` ManagerId — unresolved $ref
    - `name` union
      - Name — unresolved $ref
      - object
        - `eq` Name — unresolved $ref
        - `not_eq` Name — unresolved $ref
        - `contains` Name — unresolved $ref
        - `not_contain` Name — unresolved $ref
    - `created_at` union
      - CreatedAt — unresolved $ref
      - object
        - `not_contain` CreatedAt — unresolved $ref
        - `eq` CreatedAt — unresolved $ref
        - `not_eq` CreatedAt — unresolved $ref
        - `contains` CreatedAt — unresolved $ref
    - `title` union — Filter agents by their job title or functional role description.
      - Title — unresolved $ref
      - object
        - `eq` Title — unresolved $ref
        - `contains` Title — unresolved $ref
        - `not_eq` Title — unresolved $ref
        - `not_contain` Title — unresolved $ref
    - `deactivated_at` union — Filter agents by the timestamp when they were deactivated. Pass `null` to filter for active agents.
      - object
        - `not_contain` DeactivatedAt — unresolved $ref
        - `eq` DeactivatedAt — unresolved $ref
        - `not_eq` DeactivatedAt — unresolved $ref
        - `contains` DeactivatedAt — unresolved $ref
      - DeactivatedAt — unresolved $ref
    - `custom_role_id` union — Filter agents by their assigned custom role ID.
      - CustomRoleId — unresolved $ref
      - object
        - `not_contain` CustomRoleId — unresolved $ref
        - `eq` CustomRoleId — unresolved $ref
        - `not_eq` CustomRoleId — unresolved $ref
        - `contains` CustomRoleId — unresolved $ref
    - `query` union
      - object
        - `not_contain` Query — unresolved $ref
        - `contains` Query — unresolved $ref
        - `eq` Query — unresolved $ref
        - `not_eq` Query — unresolved $ref
      - Query — unresolved $ref
    - `id` union
      - object
        - `not_contain` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `eq` Id — unresolved $ref
      - Id — unresolved $ref
    - `status` union
      - StatusId — unresolved $ref
      - object
        - `contains` StatusId — unresolved $ref
        - `not_eq` StatusId — unresolved $ref
        - `eq` StatusId — unresolved $ref
        - `not_contain` StatusId — unresolved $ref

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection agent

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/11e8576224b8/schema)