Skip to main content
GET
List agents
Lists the agents belonging to the API key’s company, with pagination.

Overview

Returns every agent available to your company — useful for picking one before creating a conversation, and for auditing what you have.

Use Cases

  • Find Existing Agents: Locate an agent before scheduling a call
  • Agent Management: Review and audit all configured agents
  • Bulk Operations: Retrieve agents for scheduling calls in bulk
  • Agent Discovery: Browse available agents by type or purpose

Basic Usage

With Pagination

Finding an Agent by Type

The endpoint is paginated, so walk every page before filtering — a company with more agents than one page holds would otherwise lose the matches sitting on later pages.

Company Scoping

All returned agents belong to your API key’s company. ATS keys can filter by companyId to access agents from specific companies they manage.

Agents Resource Guide

Learn about agent configuration and best practices

Create Agent

Create a new agent

Pagination Guide

Understand pagination best practices

Authorizations

Authorization
string
header
required

API key for authentication using Bearer scheme

Query Parameters

page
integer
default:1

Page number (1-based)

Required range: 1 <= x <= 10000
Example:

1

limit
integer
default:20

Number of items per page

Required range: 1 <= x <= 100
Example:

20

companyId
string<uuid>

Filter agents by company ID. If omitted, defaults to the API key's company.

Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

200 - application/json
data
object[]
required

Array of agents

total
number
required

Total number of items

Example:

150

page
number
required

Current page number

Example:

1

limit
number
required

Number of items per page

Example:

20

totalPages
number
required

Total number of pages

Example:

8