> ## 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

> List the agents visible to your PIN account.

List the agents visible to you. Returns an array of agent objects with the same fields as [Get an Agent](https://docs.ariacompute.com/api-reference/pin/agents/get.md).

## Endpoint

**GET** `/v1/agents`

Authorization: Bearer API key required.

## Response

**items** `array`

Array of agent objects. Each contains `id`, `name`, `gpu_count`, `gpu_mem_gb`, `labels`, `gpus`, `last_heartbeat`, `status`, `node_id`, `version`, `deploy_state`, `last_error`, `agent_uid`. See [Get an Agent](https://docs.ariacompute.com/api-reference/pin/agents/get.md).

## Example

```bash theme={null}
curl -s http://<pin-host>:8001/v1/agents \
  -H "Authorization: Bearer $ARIA_PIN_KEY"
```

```json theme={null}
{
  "items": [
    {
      "id": "ag_7f8e9d0c",
      "name": "training-agent",
      "gpu_count": 8,
      "gpu_mem_gb": 640,
      "labels": ["training", "a100"],
      "status": "online",
      "node_id": "gn_a1b2c3d4",
      "version": "1.2.0",
      "deploy_state": "deployed"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.