About this dataset
Holding Company Directory is a Public dataset in the Holding Companies group of the BankRegReports Data API. The response carries 8 documented fields, sourced from Fed FR Y-9C.
Endpoint
GET /api/v1/holding-cos/ Parameters
| Name | Required | Description |
|---|---|---|
| q | optional | Name search, case-insensitive. Matches any part of the legal name; when that finds nothing, falls back to the site's name matcher, which forgives punctuation, spacing and common abbreviations. e.g. first citizens |
| limit | optional | integer |
Response fields
| Field | Type | Description |
|---|---|---|
| rssd_id | integer, nullable | RSSD ID (count) |
| report_date | string (date), nullable | Report Date (date) |
| total_assets | string (decimal), nullable | Total Assets (USD thousands) |
| total_loans | string (decimal), nullable | Total Loans (USD thousands) |
| financial_asset_equity_adj | string (decimal), nullable | |
| net_income | string (decimal), nullable | Net Income (USD thousands). Net income (loss) after tax, as reported on the Call Report income statement. The figure is the single quarter, not a year-to-date total. |
| roa | string (decimal), 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 | string (decimal), nullable | Return on Equity (percent) |
Example request
curl "https://api.bankregreports.com/api/v1/holding-cos/" \ -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",
"report_date": "string (date)",
"total_assets": "string (decimal)",
"total_loans": "string (decimal)",
"financial_asset_equity_adj": "string (decimal)",
"net_income": "string (decimal)",
"roa": "string (decimal)",
"roe": "string (decimal)"
}
],
"meta": { ... }
} When to use it
Holding Company Directory sits in the Holding Companies 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 holding_companies 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
- Holding Company Snapshot: Latest snapshot for one bank holding company.
- Holding Company Trends: Quarterly metric time series for one bank holding company.
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.holding_companies()