> ## Documentation Index > Fetch the complete documentation index at: https://docs.getkarta.ai/llms.txt > Use this file to discover all available pages before exploring further. # List agents > List your agents with pagination. Use `agent_code` as `agent_id` in call and session requests. For the next page, use `pagination.nextOffset` while `pagination.hasMore` is `true`. ## OpenAPI ````yaml openapi.json GET /client/agents openapi: 3.1.0 info: title: Karta Public API version: 1.0.0-draft description: >- Karta API reference for accounts, agents, calls, campaigns, WebSocket sessions, and billing. servers: - url: https://api.getkarta.ai/public/v1 description: Production security: - BearerApiKey: [] tags: - name: Account - name: Agents - name: Calls - name: Phone numbers - name: Campaigns - name: Realtime - name: Billing - name: Webhooks description: Outgoing call events delivered to your server. paths: /client/agents: get: tags: - Agents summary: List agents description: List your agents with pagination. operationId: listAgents parameters: - name: X-Request-ID in: header required: false description: Optional request-tracing identifier. schema: type: string example: example-request-001 - name: limit in: query required: false description: Maximum number of items to return. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: offset in: query required: false description: Number of items to skip. schema: type: integer minimum: 0 default: 0 - name: status in: query required: false description: Filter by agent status. schema: type: string enum: - live - archive - name: type in: query required: false description: Filter by agent type. schema: type: string enum: - chat - voice - onboarding - audit - name: q in: query required: false description: Search by agent name (case-insensitive). schema: type: string maxLength: 100 - name: sort in: query required: false description: Sort order; a leading minus means descending. schema: type: string enum: - created_at - '-created_at' - updated_at - '-updated_at' - name - '-name' default: '-created_at' responses: '200': description: Successful response. headers: X-Request-ID: description: Request identifier. schema: type: string content: application/json: schema: $ref: '#/components/schemas/AgentPage' example: data: - agent_code: agentexample name: Support agent pagination: limit: 20 offset: 0 nextOffset: null hasMore: false '400': description: Invalid request or account configuration. headers: X-Request-ID: description: Request identifier. schema: type: string content: application/json: schema: anyOf: - $ref: '#/components/schemas/AuthProblem' title: Authentication or account configuration error - $ref: '#/components/schemas/RequestProcessingError' title: Request processing error - $ref: '#/components/schemas/AgentProblem' title: Agent query error examples: configuration: summary: Account configuration error value: type: https://httpstatus.es/400 title: Missing Data Residency status: 400 detail: Client dataResidency not set. Please contact support. instance: example-request-001 code: missing_data_residency request: summary: Request parsing error (illustrative message) value: message: Unexpected end of JSON input AgentProblem: summary: Invalid agent query value: type: https://httpstatus.es/400 title: Invalid Query Parameter status: 400 detail: One or more query parameters are invalid instance: example-request-001 traceId: example-request-001 code: invalid_query errors: - path: limit message: limit must be an integer between 1 and 100 '401': description: Authentication failed. headers: X-Request-ID: description: Request identifier. schema: type: string content: application/json: schema: $ref: '#/components/schemas/AuthProblem' title: Authentication or account configuration error examples: authentication: summary: Missing API key value: type: https://httpstatus.es/401 title: Invalid API Key status: 401 detail: API key is required instance: example-request-001 code: invalid_api_key '403': description: API key not permitted for this operation. headers: X-Request-ID: description: Request identifier. schema: type: string content: application/json: schema: $ref: '#/components/schemas/AuthProblem' title: Authentication or account configuration error examples: authentication: summary: Wrong key type value: type: https://httpstatus.es/403 title: Wrong API Key Type status: 403 detail: Widget API keys may only be used on /widget paths instance: example-request-001 code: wrong_key_audience '500': description: Internal server error. headers: X-Request-ID: description: Request identifier. schema: type: string content: application/json: schema: anyOf: - $ref: '#/components/schemas/AuthProblem' title: Authentication or account configuration error - $ref: '#/components/schemas/RequestProcessingError' title: Request processing error examples: authentication: summary: Authentication failure value: type: https://httpstatus.es/500 title: Internal Server Error status: 500 detail: Authentication failed instance: example-request-001 code: internal_error request: summary: Request processing failure value: message: Internal Server Error components: schemas: AgentPage: type: object properties: data: type: array items: type: object properties: agent_code: type: string description: Use as agent_id when creating a call or session. name: type: string pagination: type: object properties: limit: type: integer offset: type: integer nextOffset: type: - integer - 'null' hasMore: type: boolean AuthProblem: type: object properties: type: type: string description: Identifier for this error category. title: type: string description: Short summary of the error. status: type: integer description: HTTP status code for this response. detail: type: string description: Explanation of the failure. instance: type: string description: Request identifier. code: type: string description: Machine-readable error code. title: Authentication or account configuration error RequestProcessingError: title: Request processing error type: object properties: message: type: string description: Description of the request-processing failure. errors: type: array items: additionalProperties: true type: object description: Additional error details, when supplied. AgentProblem: type: object properties: type: type: string description: Identifier for this error category. title: type: string description: Short summary of the error. status: type: integer description: HTTP status code for this response. detail: type: string description: Explanation of the failure. instance: type: string description: Request identifier. code: type: string description: Machine-readable error code. traceId: type: string description: Request identifier for support and troubleshooting. errors: type: array items: type: object properties: path: type: string message: type: string title: Agent query error securitySchemes: BearerApiKey: type: http scheme: bearer description: 'API key in the format: Bearer YOUR_KARTA_API_KEY.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.