---
title: "US bank branch locations (FDIC BankFind)"
method: GET
path: "/api/v1/equities/{symbol}/bank-branches"
tags: ["Equities Indices"]
---

# US bank branch locations (FDIC BankFind)

`GET /api/v1/equities/{symbol}/bank-branches`

Branch/office locations for a US-listed bank from the FDIC BankFind Suite (Tier S, primary source). The ticker is mapped to an FDIC certificate by confidence: a curated seed map of the major US bank holding companies, else the company's SEC registrant name matched against the FDIC holding-company name (NAMEHCR) - an exact multi-token match auto-resolves, otherwise a 404 returns candidate institutions to disambiguate. Pass ?cert= to override resolution with an exact FDIC certificate. Filter by ?state= (two-letter) for regional analysis. Counts cover the matched insured bank only; trust / card / online banks correctly show few offices.

## Path parameters

- `symbol` string, required — Bank ticker symbol.

## Query parameters

- `cert` integer, nullable — Override resolution with an exact FDIC certificate number.
- `state` string, nullable — Two-letter state code to filter branches (e.g. CA).
- `offset` integer — Pagination offset.
- `limit` integer — Branches per page (max 1000).

## Response `200`

The matched FDIC-insured institution plus a paginated list of its branch/office locations (address, county, service type, established date), optionally filtered by state.

- EnvelopeBankBranchesData
  - `data` BankBranchesData, required — DATA-5.5: US bank branch locations by ticker, via the FDIC crosswalk.
    - `symbol` string, nullable
    - `resolution` BankBranchResolution, required — How the ticker (or cert) was mapped to an FDIC insured bank.
      - `method` string, required — explicit_cert | curated_map | name_match.
      - `cert` integer, required — FDIC certificate number of the matched bank.
      - `confidence` number, nullable — 1.0 for a curated/exact match; null for an explicit cert.
      - `matched_holding_company` string, nullable — FDIC holding-company name (NAMEHCR) the match keyed on.
    - `institution` BankInstitution — Summary of the matched FDIC-insured institution.
      - `cert` integer, nullable
      - `name` string, nullable
      - `holding_company` string, nullable
      - `holding_company_rssd` string, nullable
      - `active` boolean, nullable — FDIC active flag; null if unknown.
      - `main_office_city` string, nullable
      - `main_office_state` string, nullable
      - `total_offices` integer, nullable — Total insured offices for this cert.
      - `assets_usd_thousands` integer, nullable
      - `as_of` string, nullable — FDIC report date (ISO).
      - `website` string, nullable
    - `filters` BankBranchFilters, required
      - `state` string, nullable — Two-letter state filter, if applied.
    - `branch_count` integer, required — Total branches matching the filter.
    - `offset` integer
    - `limit` integer
    - `returned` integer, required — Branches in this page.
    - `branches` BankBranch[], required
      - `uninum` integer, nullable — FDIC unique office number.
      - `name` string, nullable
      - `service_type` integer, nullable — FDIC service-type code.
      - `service_type_desc` string, nullable
      - `is_main_office` boolean
      - `established` string, nullable — Branch established date (ISO).
      - `address` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `zip` string, nullable
      - `county` string, nullable
    - `note` string, required
  - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope.
    - `endpoint` string, required — Requested endpoint path.
    - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request.
    - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced.
    - `provider` string, required — API name and version.
    - `source` string, nullable — Identifier of the primary upstream source used for this response.
    - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response.
    - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data.
    - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried.
    - `cached` boolean, nullable — True when this response was served from the internal cache.
    - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data.

## Other responses

- `400` — Invalid ticker symbol.
- `401` — Missing or invalid `x-api-key` header.
- `404` — Symbol not resolvable to an FDIC bank (candidates returned), or unknown cert.
- `422` — Validation Error
- `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window.
- `502` — FDIC BankFind or the ticker lookup is temporarily unavailable.
- `503` — Upstream source is temporarily unavailable. Retry after a short delay.

---

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