> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Agents

> This endpoint gets agents

### Query Parameters (optional)

<ParamField query="limit" type="number" optional="true">
  Number of agents to return. Defaults to 20.
</ParamField>

<ParamField query="offset" type="number" optional="true">
  Offset for pagination. Defaults to 0.
</ParamField>

### Response

<ResponseField name="agent_name" type="string">
  The name of the created agent.
</ResponseField>

<ResponseField name="agent_type" type="string">
  The type of the created agent.
</ResponseField>

<ResponseField name="description" type="string">
  The description of the created agent.
</ResponseField>

<ResponseField name="activated" type="string">
  The activation status of the created agent.
</ResponseField>

<ResponseField name="created_at" type="string">
  The date and time the agent was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  The date and time the agent was last updated.
</ResponseField>

<ResponseField name="org_id" type="string">
  The organization ID to which the agent belongs.
</ResponseField>

<ResponseField name="voice_model" type="string">
  The voice model associated with the agent.
</ResponseField>

<ResponseField name="voice_model_id" type="string">
  The voice model ID associated with the agent.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://api.stateset.com/v1/agents?limit=20&offset=0' \
  --header 'Authorization: Bearer <api_key>'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "id": "agent_123",
      "agent_name": "Support Bot",
      "agent_type": "Conversational AI Agent",
      "description": "Handles order status and returns",
      "activated": true,
      "org_id": "org_456"
    }
  ]
  ```
</ResponseExample>