Screener Dataset (full working set)

About this dataset

Screener Dataset (full working set) is a Pro dataset in the Screeners group of the BankRegReports Data API. The response carries 21 documented fields, sourced from FFIEC + FDIC.

The ENTIRE bank-screener working set in one response, every bank with the screener columns, no pagination, for the PAID client-side screener that loads it once and re-slices in the browser (plain JS). Paid-tier only: this is exactly the bulk dataset the anti-bulk pagination guard withholds from free/anonymous callers, so it stays gated behind IsPaidOrAbove.

Endpoint

GET /api/v1/screener/dataset/

Response fields

Field	Type	Description
rssd_id	integer	RSSD ID (count)
fdic_cert	integer, nullable	FDIC Certificate (count)
legal_name	string	Legal Name (text)
hq_city	string, nullable	Headquarters City (text)
hq_state	string, nullable	Headquarters State (text)
asset_tier	string, nullable	Asset Tier (text)
total_assets	number (double), nullable	Total Assets (USD thousands)
cet1_ratio	number (double), nullable	CET1 Capital Ratio (percent). Common Equity Tier 1 capital as a percentage of risk-weighted assets, the strictest measure of bank capital. The prompt corrective action "well capitalized" level is 6.5%; the 4.5% minimum plus the 2.5% conservation buffer is 7.0%, below which dividends and bonuses are limited. FFIEC 031 filers report it as RCFAP793 and FFIEC 041/051 filers as RCOAP793 (standardized approach). A bank under the advanced approaches also reports RCFWP793; the ratio shown is the lower of the two, the binding ratio FDIC publishes. Banks in the community bank leverage ratio framework do not report it.
npl_ratio	number (double), nullable	Non-Performing Loan Ratio (percent). Noncurrent loans (nonaccrual plus 90+ days past due and still accruing) as a percentage of total loans, the FDIC and UBPR definition; consolidated lines for FFIEC 031 filers. Performing modifications to borrowers in financial difficulty are not counted. Lower is better. The Healthy and Watch bands below are BankRegReports screening bands (2% and 5%), not regulatory triggers; no supervisory NPL threshold exists.
texas_ratio	number (double), nullable	Texas Ratio (percent). Problem assets divided by tangible equity plus the allowance for credit losses. Problem assets are nonaccrual loans, loans 90 or more days past due and still accruing, and other real estate owned, net of the U.S. government-guaranteed portions; modified loans are not included. Tangible equity is total equity capital less intangible assets other than mortgage servicing assets. Above 100% has historically signaled elevated failure risk.
roa	number (double), nullable	Return on Assets (percent). Net income, annualized, as a percentage of average total assets. The single most-cited profitability metric. 1.0%+ is strong for national banks; community banks often run 0.8 to 1.2%.
roe	number (double), nullable	Return on Equity (percent)
nim	number (double), nullable
efficiency_ratio	number (double), nullable	Efficiency Ratio (percent). Non-interest expense divided by the sum of net interest income and non-interest income. Lower is better. Below 60% is excellent; above 75% raises operational-leverage concerns.
leverage_ratio	number (double), nullable	Tier 1 Leverage Ratio (percent)
cre_to_capital	number (double), nullable
cd_to_capital	number (double), nullable
report_date	string, nullable	Report Date (date)
is_well_capitalized	boolean, nullable
charter_type	string, nullable
flags	array of string

Example request

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

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

Example response shape

A successful call returns HTTP 200 with a JSON body. Each row in data carries the fields below, shown with their documented types rather than sample values.

{
  "data": [
    {
      "rssd_id": "integer",
      "fdic_cert": "integer",
      "legal_name": "string",
      "hq_city": "string",
      "hq_state": "string",
      "asset_tier": "string",
      "total_assets": "number (double)",
      "cet1_ratio": "number (double)"
      ... 13 more fields
    }
  ],
  "meta": { ... }
}

When to use it

Screener Dataset (full working set) sits in the Screeners 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 screener_dataset naming it the same way in the REST path, the Python SDK and the OpenAPI document.

Access and authentication

This dataset is in the Pro tier. Send your API token in the Authorization header as a Bearer token, using a GET request to the endpoint above. The Pro 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

• Bank Screener: Every FDIC-insured bank with key ratios; filter, sort, paginate.
• Loan-Concentration Screener: Screen banks by loan-portfolio concentration.
• M&A Target Screener: Banks scored as likely acquisition targets.
• Custom Peer Groups: List or save the caller's custom peer groups.

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.screener_dataset()