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

# REST endpoints

> Versioned read endpoints for agents, sessions, and decisions.

The REST API exposes the [agent → session → decision](/concepts/agents-sessions-decisions)
hierarchy under `/v1`. All endpoints require a bearer token
([Authentication](/api-reference/authentication)) and are tenant-scoped.

<Info>
  For interactive analysis and natural-language queries, prefer the
  [MCP server](/mcp/overview) — it offers richer filtering and rollups than the raw REST
  endpoints.
</Info>

## List agents

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

Returns agents visible to the caller with rollup metrics (decision count, cost,
confidence, activity dates).

## List an agent's sessions

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

Returns the sessions for one agent, with aggregate stats and AI summaries.

<ParamField path="agent_id" type="string" required>Agent identifier from `GET /v1/agents`.</ParamField>

## Get a session

```http theme={null}
GET /v1/sessions/{session_id}
```

Returns a single session with its aggregate stats and health view.

<ParamField path="session_id" type="string" required />

## Get a decision

```http theme={null}
GET /v1/sessions/{session_id}/decisions/{ledger_id}
```

Returns the full audit trail for one decision — the logic trace, evidence, findings, and
artifacts.

<ParamField path="session_id" type="string" required />

<ParamField path="ledger_id" type="uuid" required>The decision's `ledger_id`.</ParamField>

## Example

```bash theme={null}
curl https://data.enfors.ai/v1/agents/claude_desktop_misha/sessions \
  -H "Authorization: Bearer enf_live_xxxxxxxx"
```

<Note>
  The data shapes returned here mirror the MCP tool responses. See the
  [Data model](/api-reference/data-model) for field definitions.
</Note>