Risk Categories

GET

/stocks/taxonomies/vX/risk-factors

This endpoint is free to use during the early-access beta period. Features may change or move to different plans later.

Access the full standardized hierarchical taxonomy used to classify risk factors in SEC filings. It includes primary, secondary, and tertiary categories with detailed descriptions and examples for consistent analysis across companies and time periods.

Use Cases: Risk classification models, category-level analytics and dashboards, cross-company comparisons, quantitative risk scoring, and thematic monitoring.

Stocks BasicFree

Stocks Starter$29/mo

Stocks Developer$79/mo

Stocks Advanced$199/mo

Stocks BasicFree

Stocks Starter$29/mo

Stocks Developer$79/mo

Stocks Advanced$199/mo

Plan AccessIncluded in all Stocks plans

Stocks BasicFree

Updated as needed

Stocks Starter$29/mo

Updated as needed

Stocks Developer$79/mo

Updated as needed

Stocks Advanced$199/mo

Updated as needed

Stocks BasicFree

Updated as needed

Stocks Starter$29/mo

Updated as needed

Stocks Developer$79/mo

Updated as needed

Stocks Advanced$199/mo

Updated as needed

Plan RecencyUpdated as needed

Plan HistoryNot applicable to this endpoint

Query Parameters

taxonomy

number

Version identifier (e.g., '1.0', '1.1') for the taxonomy Value must be a floating point number.

primary_category

string

Top-level risk category

secondary_category

string

Mid-level risk category

tertiary_category

string

Most specific risk classification

limit

integer

Limit the maximum number of results returned. Defaults to '200' if not specified. The maximum allowed limit is '1000'.

sort

string

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'taxonomy' if not specified. The sort order defaults to 'desc' if not specified.

Response Attributes

next_url

string

optional

If present, this value can be used to fetch the next page.

request_id

string

A request id assigned by the server.

results

array (object)

The results for this request.

description

string

optional

Detailed explanation of what this risk category encompasses, including specific examples and potential impacts

primary_category

string

optional

Top-level risk category

secondary_category

string

optional

Mid-level risk category

taxonomy

number

Version identifier (e.g., '1.0', '1.1') for the taxonomy

tertiary_category

string

optional

Most specific risk classification

status

enum (OK)

The status of this request's response.

Code Examples

curl -X GET "https://api.massive.com/stocks/taxonomies/vX/risk-factors"

Query URL

GET

https://api.massive.com/stocks/taxonomies/vX/risk-factors?apiKey=YOUR_API_KEY

Run query unavailable

Create account or sign in to Massive

Scroll to see updated query response

Response Object

{
  "request_id": "daac836f71724420b66011d55d88b30b",
  "results": [
    {
      "description": "Risk from inadequate performance management systems, unclear accountability structures, or ineffective measurement and incentive systems that could affect employee performance, goal achievement, and organizational effectiveness.",
      "primary_category": "Governance & Stakeholder",
      "secondary_category": "Organizational & Management",
      "taxonomy": "1.0",
      "tertiary_category": "Performance management and accountability"
    },
    {
      "description": "Risk from requirements to monitor, document, and report on compliance with privacy and data protection regulations including risks from compliance program effectiveness, record-keeping requirements, and breach notification obligations.",
      "primary_category": "Regulatory & Compliance",
      "secondary_category": "Data & Privacy",
      "taxonomy": "1.0",
      "tertiary_category": "Compliance monitoring and reporting"
    }
  ],
  "status": "OK"
}

{
  "request_id": "daac836f71724420b66011d55d88b30b",
  "results": [
    {
      "description": "Risk from inadequate performance management systems, unclear accountability structures, or ineffective measurement and incentive systems that could affect employee performance, goal achievement, and organizational effectiveness.",
      "primary_category": "Governance & Stakeholder",
      "secondary_category": "Organizational & Management",
      "taxonomy": "1.0",
      "tertiary_category": "Performance management and accountability"
    },
    {
      "description": "Risk from requirements to monitor, document, and report on compliance with privacy and data protection regulations including risks from compliance program effectiveness, record-keeping requirements, and breach notification obligations.",
      "primary_category": "Regulatory & Compliance",
      "secondary_category": "Data & Privacy",
      "taxonomy": "1.0",
      "tertiary_category": "Compliance monitoring and reporting"
    }
  ],
  "status": "OK"
}