---
title: "GET /api/me/agents/overview"
method: GET
path: "/api/me/agents/overview"
tags: ["me_agents"]
---

# GET /api/me/agents/overview

`GET /api/me/agents/overview`

## Request

- Base URL: `https://api.aifinpay.io`
- URL: `https://api.aifinpay.io/api/me/agents/overview`
- Auth: API key in cookie `aifinpay_session`

## Query parameters

- `view` 'grouped'

## Response `200`

Legacy address list by default; grouped logical-agent view when view=grouped

- union
  - object
    - `window` integer, required
    - `agents` AgentWalletView[], required
      - `address` string, required
      - `chain` string, required
      - `label` string, nullable
      - `wallet_id` string, nullable
      - `balance_usd` number, nullable, required
      - `balance_native` number, nullable, required
      - `balance_usd_total` number, nullable
      - `calls_window` integer, nullable, required
      - `spent_usd_window` number, nullable, required
      - `last_activity_ts` integer, nullable
      - `health` 'ok' | 'attention' | 'alert', required
  - GroupedAgentOverview
    - `window` integer, required
    - `agents` LogicalAgentView[], required
      - `agent_id` string, nullable, required
      - `label` string, nullable, required
      - `wallet_id` string, nullable, required
      - `source` 'claimed' | 'partner', required
      - `wallets` AgentWalletView[], required
        - `address` string, required
        - `chain` string, required
        - `label` string, nullable
        - `wallet_id` string, nullable
        - `balance_usd` number, nullable, required
        - `balance_native` number, nullable, required
        - `balance_usd_total` number, nullable
        - `calls_window` integer, nullable, required
        - `spent_usd_window` number, nullable, required
        - `last_activity_ts` integer, nullable
        - `health` 'ok' | 'attention' | 'alert', required
      - `balance_usd_total` number, nullable, required
      - `balance_coverage` object, required
        - `priced_wallets` integer, required
        - `total_wallets` integer, required
      - `calls_window` integer, nullable, required
      - `spent_usd_window` number, nullable, required
      - `history_coverage` object, required
        - `supported_wallets` integer, required
        - `total_wallets` integer, required
      - `last_activity_ts` integer, nullable, required
      - `top_merchant` string, nullable, required
      - `health` 'ok' | 'attention' | 'alert', required

## Other responses

- `400`: AIFP-* error envelope. See backend/server.js safe error handler.
- `401`: AIFP-* error envelope. See backend/server.js safe error handler.
- `403`: AIFP-* error envelope. See backend/server.js safe error handler.
- `404`: AIFP-* error envelope. See backend/server.js safe error handler.
- `429`: AIFP-* error envelope. See backend/server.js safe error handler.
- `5XX`: AIFP-* error envelope. See backend/server.js safe error handler.

---

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