List Audio Agents

Returns a paginated list of agents in your organization (or project) that have a voice configuration assigned — i.e. agents you can start a voice session with.

GET /api/v1/voice-agents

Query parameters

Parameter	Type	Required	Description
`page`	integer	No	Page number, 1-indexed. Default `1`.
`limit`	integer	No	Results per page, max `100`. Default `20`.
`projectRefId`	string (UUID)	No	Filter to one project. Org-scoped keys only — ignored for project-scoped keys, which always see only their own project.

Response

200 OK

{
  "data": [
    {
      "agentId": "3f9c1a2e-...",
      "name": "Support Bot",
      "description": "Handles Tier 1 support tickets",
      "voiceConfigId": "8b1e0c4a-...",
      "voiceProvider": "elevenlabs",
      "sttProvider": "google",
      "projectId": null
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}

voiceProvider is the text-to-speech provider synthesizing the agent's voice; sttProvider is the speech-to-text provider transcribing the caller.

Errors

Status	`error`	When
`400`	validation error (`{ "errors": [...] }`)	`page`/`limit`/`projectRefId` fails validation
`422`	`project_not_found`	`projectRefId` doesn't belong to your organization
`429`	`rate_limit_exceeded`	More than 100 requests/minute for this key on this endpoint — see Rate Limits

Example

curl "https://api.elizon.com/api/v1/voice-agents?limit=50" \
  -H "X-API-Key: elz_your_key_here"

List Audio Agents

Query parameters

Response

Errors

Example

On this page