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

# List Agents - GET /v1/agents

> Retrieve a list of all agents. Returns an OpenAI-compatible list object with agent data, supporting standard pagination fields.

Retrieve every agent you have created. The response follows the OpenAI list object pattern with an `object` field of `list` and a `data` array containing full agent objects.

## Endpoint

```http theme={null}
GET /v1/agents
```

## Authentication

`Authorization: Bearer <api_key>` or `Authorization: ApiKey <key>`. Optional if `AGENT_CLOUD_API_KEY` is unset at server boot.

## Response

<ResponseField name="object" type="string">
  Always `list`.
</ResponseField>

<ResponseField name="data" type="array">
  Array of agent objects.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://agent.example.com/v1/agents \
    -H "Authorization: Bearer <api_key>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "ag_01J1234567890ABCDEF",
        "object": "agent",
        "name": "SupportBot",
        "model": "gpt-4o",
        "instructions": "You are a helpful support assistant.",
        "tools": [],
        "metadata": { "team": "support" }
      }
    ]
  }
  ```
</ResponseExample>


## Related topics

- [List and Deploy Node Agents](/api-reference/pin/gpu-nodes/agents.md)
- [Get an Agent](/api-reference/pin/agents/get.md)
- [Create Agent - POST /v1/agents](/api-reference/agent/agents/create.md)
- [GET /v1/apikeys: List PIN API Keys](/api-reference/pin/apikeys/list.md)
- [GET /v1/models: List router entrypoints and provider models](/api-reference/router/openai/list-models.md)