curl -X GET 'https://api.elevenlabs.io/v1/convai/agents?page_size=30&search=example-search&archived=false&show_only_owned_agents=false&created_by_user_id=created-by-user-id&tags=example&sort_direction=asc&sort_by=name&cursor=example-cursor' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

# GET /v1/convai/agents (ElevenLabs API)
Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03

> List Agents

## Critical Gotchas
* Authentication uses the non-standard `xi-api-key` header, not `Authorization: Bearer`. Sending a Bearer token returns HTTP 401.
* Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (`--output speech.mp3`) rather than parsing it.

## cURL
curl -X GET 'https://api.elevenlabs.io/v1/convai/agents?page_size=30&search=example-search&archived=false&show_only_owned_agents=false&created_by_user_id=created-by-user-id&tags=example&sort_direction=asc&sort_by=name&cursor=example-cursor' \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| page_size | query | integer | No | How many Agents to return at maximum. Can not exceed 100,... |
| search | query | string | No | Search by agents name. |
| archived | query | boolean | No | Filter agents by archived status |
| show_only_owned_agents | query | boolean | No | If set to true, the endpoint will omit any agents that we... |

## Response (200 OK)
{"agents":[{}],"has_more":false}

---
Need an API key? Get one at https://elevenlabs.io/app/sign-up

GET

/v1/convai/agents

ElevenLabs API

List Agents

Base URL: https://api.elevenlabs.io
Auth: xi-api-key: <ELEVENLABS_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 232 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X GET 'https://api.elevenlabs.io/v1/convai/agents?page_size=30&search=example-search&archived=false&show_only_owned_agents=false&created_by_user_id=created-by-user-id&tags=example&sort_direction=asc&sort_by=name&cursor=example-cursor' \  -H "xi-api-key: $ELEVENLABS_API_KEY"

Get a free ElevenLabs API key → sponsored

Parameters

Name	In	Type	Required	Description
page_size	query	integer	No	How many Agents to return at maximum. Can not exceed 100, defaults to 30.
search	query	string	No	Search by agents name.
archived	query	boolean	No	Filter agents by archived status
show_only_owned_agents	query	boolean	No	If set to true, the endpoint will omit any agents that were shared with you by someone else and include only the ones you own. Deprecated: use created_by_user_id instead.
created_by_user_id	query	string	No	Filter agents by creator user ID. When set, only agents created by this user are returned. Takes precedence over show_only_owned_agents. Use '@me' to refer to the authenticated user.
tags	query	string[]	No	Filter agents by tag. Repeat the parameter to match any of several tags.
sort_direction	query	string	No	The direction to sort the results
sort_by	query	string	No	The field to sort the results by
cursor	query	string	No	Used for fetching next page. Cursor is returned in the response.

Response 200 OK

{
  "agents": [
    {
      "access_info": {
        "creator_email": "john@example.com",
        "creator_name": "John Doe",
        "is_creator": true,
        "role": "admin"
      },
      "agent_id": "J3Pbu5gP6NNKBscdCdwB",
      "archived": false,
      "created_at_unix_secs": 1716153600,
      "name": "My Agent",
      "tags": [
        "Customer Support",
        "Technical Help",
        "Eleven"
      ],
      "voice_id": "UCaNsl8F6Xh4GALkVMLS"
    }
  ],
  "has_more": false,
  "next_cursor": "123"
}