HMDA Mortgage-Lending Book
FreePer-bank Home Mortgage Disclosure Act book - applications, originations, denials, and USD volumes by activity year and state.
About this dataset
HMDA Mortgage-Lending Book is a Free dataset in the Banks group of the BankRegReports Data API. The response carries 17 documented fields, sourced from FFIEC HMDA LAR.
GET /api/v1/banks/{rssd_id}/hmda/ - HMDA applications/originations/denials.
Endpoint
GET /api/v1/banks/{rssd_id}/hmda/ Parameters
| Name | Required | Description |
|---|---|---|
| rssd_id | required | Federal Reserve RSSD id. e.g. 852218 |
Response fields
| Field | Type | Description |
|---|---|---|
| lei | string, nullable | Legal Entity Identifier (text) |
| activity_year | integer, nullable | |
| state_code | string, nullable | |
| legal_name | string, nullable | Legal Name (text) |
| n_applications | integer, nullable | |
| n_originated | integer, nullable | |
| n_approved_not_accepted | integer, nullable | |
| n_denied | integer, nullable | |
| n_purchased | integer, nullable | |
| n_withdrawn_or_incomplete | integer, nullable | |
| usd_originated | number (double), nullable | |
| usd_purchased | number (double), nullable | |
| avg_loan_amount_originated | number (double), nullable | |
| avg_interest_rate_originated | number (double), nullable | |
| n_originated_purchase | integer, nullable | |
| n_originated_refi | integer, nullable | |
| denial_rate | number (double), nullable |
Example request
curl "https://api.bankregreports.com/api/v1/banks/852218/hmda/" \ -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": [
{
"lei": "string",
"activity_year": "integer",
"state_code": "string",
"legal_name": "string",
"n_applications": "integer",
"n_originated": "integer",
"n_approved_not_accepted": "integer",
"n_denied": "integer"
... 9 more fields
}
],
"meta": { ... }
} When to use it
HMDA Mortgage-Lending Book sits in the Banks 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 hmda naming it the same way in the REST path, the Python SDK and the OpenAPI document.
Access and authentication
This dataset is in the Free 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
- Bank Directory: Directory of all FDIC-insured banks with identity + headline figures.
- Bank Snapshot: Latest filed-quarter snapshot for one bank: balance sheet, capital, ratios.
- Bank Trends: Quarterly time series of key metrics for one bank.
- FDIC Bank Demographics: FDIC institution demographics for one bank - CBSA/metro-micro classification, minority-status designation, head-office latitude/longitude, web URL, and office-count rollups, by as-of quarter.
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 rssd_id = 852218 # JPMorgan Chase Bank, N.A. result = brr.bank_hmda(rssd_id=rssd_id)