Skip to main content
← All datasets

10-K/Q Filing Narratives

Free

Per-filing 10-K/Q narrative text blobs (MD&A / risk factors) for one bank's registrant. Large bodies are truncated server-side.

About this dataset

10-K/Q Filing Narratives is a Free dataset in the SEC Data group of the BankRegReports Data API. The response carries 11 documented fields, sourced from SEC EDGAR 10-K / 10-Q.

Per-filing 10-K/Q narrative text blobs (MD&A / risk factors) for one bank.

Large free text: capped to 50 rows and each body truncated server-side; `body_truncated` flags a cut and `body_chars` is the original length.

Endpoint

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

Parameters

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

Response fields

Field Type Description
accession_number string
form string, nullable
filing_date string (date), nullable
body_text string, nullable
body_chars integer, nullable
body_truncated boolean, nullable
primary_document string, nullable
cik integer, nullable SEC CIK (count)
ticker string, nullable Ticker (text)
nic_legal_name string, nullable
match_confidence string, nullable

Example request

curl "https://api.bankregreports.com/api/v1/banks/852218/sec/narratives/" \
  -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": [
    {
      "accession_number": "string",
      "form": "string",
      "filing_date": "string (date)",
      "body_text": "string",
      "body_chars": "integer",
      "body_truncated": "boolean",
      "primary_document": "string",
      "cik": "integer"
      ... 3 more fields
    }
  ],
  "meta": { ... }
}

When to use it

10-K/Q Filing Narratives 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 filing_narratives 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

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

The Python SDK does not have a method for this dataset yet. Call the REST endpoint above with any HTTP client.

Powered by BankRegReports API