Reference Tables

Public

Reference lookup tables (states, regulators, …).

About this dataset

Reference Tables is a Public dataset in the Reference & Catalog group of the BankRegReports Data API.

Returns up to `limit` rows from the requested reference table. Use for small near-static lookups (states, regulators, charter codes). For MDRM use /reference/mdrm/<code>/ for the validity-window-aware tooltip instead, the full MDRM table is 82K rows. Cached 24h.

Endpoint

GET /api/v1/reference/{slug}/

Parameters

Name	Required	Description
slug	required	Reference table slug. e.g. states
limit	optional	Max rows (default 1000, max 10000). e.g. 1000

Example request

curl "https://api.bankregreports.com/api/v1/reference/states/" \
  -H "Authorization: Bearer $BANKREG_API_TOKEN"

Responses are JSON in a {"data": ..., "meta": {...}} envelope. Get a token on the setup page.

When to use it

Reference Tables sits in the Reference & Catalog group of the Data API. Reach for it when your work needs this data straight from the API: it comes back as JSON you can load into a notebook, a spreadsheet or a scheduled pipeline, with the dataset key reference naming it the same way in the REST path, the Python SDK and the OpenAPI document.

Access and authentication

This dataset is in the Public tier. Send your API token in the Authorization header as a Bearer token, using a GET request to the endpoint above. The Free plan is the first plan that includes it. Check the plan comparison for request limits, and the data update schedule for when new filings reach the API.

Related datasets

Watchlist: The authenticated user's watchlist, list or add banks (GET/POST).
Watchlist Remove: Remove a bank from the authenticated user's watchlist.
Watchlist Alerts: Threshold metric alerts for banks the user is watching (GET/POST).
Watchlist Alert Detail: Toggle or delete one watchlist alert (PATCH/DELETE).

Keep going

Browse every dataset, follow the setup walkthrough to make a first call, use the Excel add-in for formulas, or connect an assistant through the MCP server.

Python SDK

Install with pip install bankregreports and set BANKREG_API_TOKEN to your key.

import bankregreports

brr = bankregreports.BankReg()  # reads BANKREG_API_TOKEN
result = brr.reference()