---
title: "List the agents on the caller's Reason Network"
method: GET
path: "/v3/organizations/{orgId}/agent-network/agents"
tags: ["Agent network"]
---

# List the agents on the caller's Reason Network

`GET /v3/organizations/{orgId}/agent-network/agents`

## Request

- Base URL: `https://api.reasonmachines.com`
- URL: `https://api.reasonmachines.com/v3/organizations/{orgId}/agent-network/agents`
- Auth: HTTP bearer

The caller's Reason Network: its live agents across members' computers (Claude Code, Codex, Cursor, workers and others), read through a member's computer that is online with Reason running. Answers 409 `agent_network_offline` when no member computer is online, and 409 `agent_network_no_answer` when one is but didn't read the network in time or said why it couldn't (trying again is safe).

<sub>Scope: `sessions:read`</sub>

## Response `200`

The network's agents.

- AgentNetworkWho
  - `team` string, nullable, required: The network's name.
  - `agents` object[], required
    - `address` string, required: What `networkAsk` takes as `to`: person/session.
    - `person` string, required
    - `machine` string, required
    - `agent` string, required: The agent kind, such as claude-code, codex, cursor or a personal agent's name.
    - `repo` string, nullable, required
    - `branch` string, nullable, required
    - `status` string, required: busy, idle, live or offline.
    - `since` number, nullable, required: When the status began, in milliseconds since the epoch.
    - `doing` string, nullable, required: What the agent is working on, in its own words.
    - `worker` boolean, required: A headless agent a member put on the network to take work (reason network serve).
  - `computers` object[], required
    - `person` string, required
    - `machine` string, required
    - `online` boolean, required
  - `via` string, nullable, required: The member computer that read the network for this call.

## Other responses

- `401`: Missing, invalid, or expired key.
- `403`: The key lacks the required scope or role.
- `409`: No member computer is online to read the network (`agent_network_offline`), or one is but didn't read it in time or said why it couldn't (`agent_network_no_answer`).
- `429`: Too many requests. Retry after the number of seconds in the `Retry-After` response header.

## Changes

- **2026-10-16** `71ef2e9d8d33`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ara/apis/reason-api/changes/v3/organizations/:orgId/agent-network/agents/get.md)

---

[API](https://skmtc.dev/ara/apis/reason-api.md) - [All operations](https://skmtc.dev/ara/apis/reason-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ara/apis/reason-api/revisions/e97c8704807c?raw)