Skip to main content
GET
List agents
Lists all agents (interview templates) for the API key’s company with pagination support.

Overview

The list agents endpoint allows you to retrieve all available AI interview agents in your company. This is useful for finding existing agents before creating interviews, managing agent configurations, and auditing your agent library.

Use Cases

  • Find Existing Agents: Locate agents before scheduling interviews
  • Agent Management: Review and audit all configured agents
  • Bulk Operations: Retrieve agents for bulk interview scheduling
  • Agent Discovery: Browse available agents by type or purpose

Basic Usage

With Pagination

Finding Agents for Interviews

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 new interview agents

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