Skip to main content
← All datasets

Industry Peer Benchmarks

Public

Pre-computed peer-group benchmarks (mean + 5-number summary) by asset tier.

About this dataset

Industry Peer Benchmarks is a Public dataset in the Industry & Macro group of the BankRegReports Data API. The response carries 10 documented fields, sourced from BankRegReports (derived).

Pre-aggregated benchmarks for 21 standardized metrics across recent quarters and asset tiers. Each row carries n + mean + p10/p25/p50/p75/p90 for one (metric × tier × quarter) cohort. With no filters returns the full ~750-row set. Responses are cached for up to 12 hours and refresh when new filings load.

Endpoint

GET /api/v1/industry/benchmarks/

Parameters

Name Required Description
metric optional Metric id (see the `metrics` tool for valid ids). e.g. roa
asset_tier optional Asset-size tier label, one of '1: >= $250B' ... '6: < $100M' (same labels as `tier`). e.g. 4: $1B-10B
report_date optional Quarter-end date, YYYY-MM-DD. Default: latest. e.g. 2026-06-30

Response fields

Field Type Description
report_date string (date), nullable Report Date (date)
asset_tier string, nullable Asset Tier (text)
metric string, nullable
n integer, nullable
mean string (decimal), nullable
p10 string (decimal), nullable
p25 string (decimal), nullable
p50 string (decimal), nullable
p75 string (decimal), nullable
p90 string (decimal), nullable

Example request

curl "https://api.bankregreports.com/api/v1/industry/benchmarks/" \
  -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": [
    {
      "report_date": "string (date)",
      "asset_tier": "string",
      "metric": "string",
      "n": "integer",
      "mean": "string (decimal)",
      "p10": "string (decimal)",
      "p25": "string (decimal)",
      "p50": "string (decimal)"
      ... 2 more fields
    }
  ],
  "meta": { ... }
}

When to use it

Industry Peer Benchmarks sits in the Industry & Macro 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 industry_benchmarks 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

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.industry_benchmarks()
Powered by BankRegReports API