<!-- Agent Datasets docs · Banks REST endpoints · canonical: https://www.agentdatasets.com/docs/rest/banks · rendered from https://www.agentdatasets.com -->

# Banks REST endpoints

US commercial bank financials and institution profiles from the FDIC BankFind Suite.

2 endpoints. Paths are relative to `https://api.agentdatasets.com`. Every endpoint mirrors an MCP tool over the same service layer — https://www.agentdatasets.com/docs/tools.md documents the same operations for MCP clients.

## GET /v1/banks/financials

Financials

Return one institution's bounded, cursor-paged FDIC financials.

### Parameters

| Parameter | In | Type | Required | Default | Constraints | Description |
| --- | --- | --- | --- | --- | --- | --- |
| cert | query | `integer` | yes | — | — | Exact FDIC certificate number |
| metrics | query | `array<string> \| null` | no | — | — | Repeated curated metric_key filter; omit for all metrics |
| start | query | `string (date) \| null` | no | — | — | Inclusive lower report-date bound (YYYY-MM-DD) |
| end | query | `string (date) \| null` | no | — | — | Inclusive upper report-date bound (YYYY-MM-DD) |
| limit | query | `integer` | no | 8 | min 1, max 40 | Report quarters, newest first |
| cursor | query | `string \| null` | no | — | — | Opaque pagination.next_cursor from the previous response |

### Example request

Required parameters only, with values taken from the schema.

```bash
curl --fail --silent --show-error \
  --header "X-API-KEY: adk_..." \
  "https://api.agentdatasets.com/v1/banks/financials?cert=1"
```

### Response

`200` Successful Response — `BankFinancialsResult`.

- `data` `BankFinancialsData` (required) — Institution identity, requested metric vocabulary, and quarterly values.
  - `cert` `integer` (required)
  - `name` `string` (required)
  - `rssd_id` `integer | null` (required)
  - `active` `boolean` (required)
  - `city` `string | null` (required)
  - `state` `string | null` (required)
  - `period_type` `"quarter"`
  - `quarters` `array<BankFinancialsQuarter>` (required)
    - `period` `string (date)` (required)
    - `fiscal_quarter` `string` (required)
    - `values` `map<string, BankFinancialValue>` (required)
      - `[key: string]` `BankFinancialValue` — One exact quarterly metric value with its interpretation and freshness.
  - `metric_definitions` `map<string, BankMetricDefinition>` (required)
    - `[key: string]` `BankMetricDefinition` — Interpretive catalog metadata for one requested financial metric.
      - `title` `string` (required)
      - `units` `string` (required)
      - `currency` `string | null` (required)
      - `basis` `string` (required)
      - `category` `string` (required)
      - `description` `string` (required)
- `meta` `Meta` (required) — Result-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
  - `source` `string` (required)
  - `as_of` `string (date-time) | string (date) | null`
- `pagination` `Pagination | null`
  - `limit` `integer` (required)
  - `has_more` `boolean` (required)
  - `next_cursor` `string | null`

Fields are shown to 3 levels; the full schema is in https://www.agentdatasets.com/docs/machine/openapi.json

## GET /v1/banks/search

Search

Return ranked FDIC institution matches for a name or identifier.

### Parameters

| Parameter | In | Type | Required | Default | Constraints | Description |
| --- | --- | --- | --- | --- | --- | --- |
| query | query | `string` | yes | — | — | Institution name, FDIC cert, or RSSD id |
| limit | query | `integer` | no | 10 | min 1, max 50 | Maximum ranked institution matches |

### Example request

Required parameters only, with values taken from the schema.

```bash
curl --fail --silent --show-error \
  --header "X-API-KEY: adk_..." \
  "https://api.agentdatasets.com/v1/banks/search?query=QUERY"
```

### Response

`200` Successful Response — `BankInstitutionSearchResult`.

- `data` `BankInstitutionSearchData` (required) — The echoed query and its bounded, best-first institution matches.
  - `query` `string` (required)
  - `matches` `array<BankInstitutionMatch>` (required)
    - `cert` `integer` (required)
    - `rssd_id` `integer | null` (required)
    - `name` `string` (required)
    - `city` `string | null` (required)
    - `state` `string | null` (required)
    - `county_fips` `string | null` (required)
    - `county_name` `string | null` (required)
    - `active` `boolean` (required)
    - `primary_regulator` `string | null` (required)
    - `charter_class` `string | null` (required)
    - `established_date` `string (date) | null` (required)
    - `closed_date` `string (date) | null` (required)
    - `score` `integer` (required)
    - `match_reason` `string` (required)
    - `as_of` `string (date-time)` (required)
- `meta` `Meta` (required) — Result-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
  - `source` `string` (required)
  - `as_of` `string (date-time) | string (date) | null`
- `pagination` `Pagination | null`
  - `limit` `integer` (required)
  - `has_more` `boolean` (required)
  - `next_cursor` `string | null`

Fields are shown to 3 levels; the full schema is in https://www.agentdatasets.com/docs/machine/openapi.json