XBRL Financial Facts

About this dataset

XBRL Financial Facts is a Free dataset in the SEC Data group of the BankRegReports Data API. The response carries 10 documented fields, sourced from SEC EDGAR (XBRL).

Most recently filed XBRL concept facts from the bank's 10-K/Q.

Endpoint

GET /api/v1/banks/{rssd_id}/sec/facts/

Parameters

Name	Required	Description
rssd_id	required	Federal Reserve RSSD id. e.g. 852218

Response fields

Field	Type	Description
concept	string
taxonomy	string, nullable
period_end	string (date), nullable
period_start	string (date), nullable
value	number (double), nullable
unit_of_measure	string, nullable
form	string, nullable
fy	integer, nullable
fp	string, nullable
filed	string (date), nullable

Example request

curl "https://api.bankregreports.com/api/v1/banks/852218/sec/facts/" \
  -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": [
    {
      "concept": "string",
      "taxonomy": "string",
      "period_end": "string (date)",
      "period_start": "string (date)",
      "value": "number (double)",
      "unit_of_measure": "string",
      "form": "string",
      "fy": "integer"
      ... 2 more fields
    }
  ],
  "meta": { ... }
}

When to use it

XBRL Financial Facts sits in the SEC Data 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 sec_facts 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

• SEC Filing Index: SEC EDGAR filing index for one bank's registrant.
• Insider Transactions: Insider Form-4 transactions for one bank's registrant.
• 8-K Material Events: 8-K filings broken out by item number, the SEC material-event feed.
• M&A Events (SEC): Mergers & acquisitions where this bank is on either side (SEC filings).

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.sec_facts(rssd_id=rssd_id)