---
title: "Get Institution Summary"
method: GET
path: "/api/v3/accounts/{institution_id}/summary"
tags: ["Accounts"]
---

# Get Institution Summary

`GET /api/v3/accounts/{institution_id}/summary`

Return the account's activity summary, triggering a worker regeneration
when it's missing or stale. The result and freshness are delivered via the
`account_summary_ready` websocket event, so the client does not poll.

## Path parameters

- `institution_id` string, required

## Response `200`

Successful Response

- AccountSummaryResponse
  - `status` 'none' | 'generating' | 'ready' | 'failed', required
  - `summary` string, nullable
  - `summary_generated_at` string, date-time, nullable
  - `sections` object[], nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nationgraph/apis/nationgraph-api.md) · [All operations](https://skmtc.net/nationgraph/apis/nationgraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nationgraph/nationgraph-api/versions/85804e68d86d/schema)