---
title: "List a wallet's agents (seats)"
method: GET
path: "/agents"
---

# List a wallet's agents (seats)

`GET /agents`

## Request

- Base URL: `https://getsanction.com/api/v1`
- URL: `https://getsanction.com/api/v1/agents`
- Auth: API key in header `x-mgmt-key`

Lists this wallet's seats. ?scope=subtree also lists every seat in the pools beneath it, each tagged with its owning pool.

## Query parameters

- `wallet_id` string, required
- `scope` 'wallet' | 'subtree'

## Response `200`

Agents

- AgentListResponse
  - `agents` object[]
    - `id` string
    - `name` string
    - `apiKeyPrefix` string
    - `isActive` boolean
    - `createdAt` string, date-time

## Other responses

- `401`: Missing or invalid management key

---

[API](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api.md) · [All operations](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api/revisions/c645a9e4b72d?raw)