About this dataset
Consumer Rates is a Public dataset in the Rate Environment group of the BankRegReports Data API. The response carries 10 documented fields, sourced from FRB G.19.
Endpoint
GET /api/v1/rates/consumer/ Parameters
| Name | Required | Description |
|---|---|---|
| series | optional | G.19 series name, e.g. DTCNLHF_XDF_BA_N.M. e.g. DTCNLHF_XDF_BA_N.M |
| limit | optional | string |
| since | optional | string |
| until | optional | string |
Response fields
| Field | Type | Description |
|---|---|---|
| dataset | string, nullable | |
| series_name | string, nullable | |
| time_period | string (date), nullable | |
| obs_value | string (decimal), nullable | |
| obs_status | string, nullable | |
| credit_type | string, nullable | |
| holder | string, nullable | |
| seasonal_adj | string, nullable | |
| data_rep | string, nullable | |
| unit | string, nullable |
Example request
curl "https://api.bankregreports.com/api/v1/rates/consumer/" \ -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": [
{
"dataset": "string",
"series_name": "string",
"time_period": "string (date)",
"obs_value": "string (decimal)",
"obs_status": "string",
"credit_type": "string",
"holder": "string",
"seasonal_adj": "string"
... 2 more fields
}
],
"meta": { ... }
} When to use it
Consumer Rates sits in the Rate Environment 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 rates_consumer 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
- Mortgage Rates: National mortgage rate series.
- Deposit Rates: National deposit rate series.
- Treasury-Bill Rates: Treasury-bill rate series.
- Treasury Yield Curve: US Treasury yield curve (long form). Pass ?latest=1 for the current curve.
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.dataset("rates_consumer")