{"uid":"cap_hgQbaZY9rNwrobmVPdIkD","slug":"risk-factor-categories-taxonomy-4f0f974d","name":"Risk Factor Categories Taxonomy","description":"The complete list of risk factor classifications used in the risk factors endpoint. Can't find what you're looking for? POST feedback to /feedback, no charge.","url":"https://agent.massive.com/stocks/taxonomies/vX/risk-factors","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"sort":{"type":"string","default":"taxonomy.desc","description":"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."},"limit":{"type":"integer","default":200,"maximum":1000,"minimum":1,"description":"Limit the maximum number of results returned. Defaults to '200' if not specified. The maximum allowed limit is '1000'."},"taxonomy":{"type":"number","format":"double","description":"Version identifier (e.g., '1.0', '1.1') for the taxonomy Value must be a floating point number."},"taxonomy.gt":{"type":"number","format":"double","description":"Filter greater than the value. Value must be a floating point number."},"taxonomy.lt":{"type":"number","format":"double","description":"Filter less than the value. Value must be a floating point number."},"taxonomy.gte":{"type":"number","format":"double","description":"Filter greater than or equal to the value. Value must be a floating point number."},"taxonomy.lte":{"type":"number","format":"double","description":"Filter less than or equal to the value. Value must be a floating point number."},"primary_category":{"type":"string","description":"Top-level risk category"},"tertiary_category":{"type":"string","description":"Most specific risk classification"},"secondary_category":{"type":"string","description":"Mid-level risk category"},"primary_category.gt":{"type":"string","description":"Filter greater than the value."},"primary_category.lt":{"type":"string","description":"Filter less than the value."},"primary_category.gte":{"type":"string","description":"Filter greater than or equal to the value."},"primary_category.lte":{"type":"string","description":"Filter less than or equal to the value."},"tertiary_category.gt":{"type":"string","description":"Filter greater than the value."},"tertiary_category.lt":{"type":"string","description":"Filter less than the value."},"secondary_category.gt":{"type":"string","description":"Filter greater than the value."},"secondary_category.lt":{"type":"string","description":"Filter less than the value."},"tertiary_category.gte":{"type":"string","description":"Filter greater than or equal to the value."},"tertiary_category.lte":{"type":"string","description":"Filter less than or equal to the value."},"secondary_category.gte":{"type":"string","description":"Filter greater than or equal to the value."},"secondary_category.lte":{"type":"string","description":"Filter less than or equal to the value."},"primary_category.any_of":{"type":"string","description":"Filter equal to any of the values. Multiple values can be specified by using a comma separated list."},"tertiary_category.any_of":{"type":"string","description":"Filter equal to any of the values. Multiple values can be specified by using a comma separated list."},"secondary_category.any_of":{"type":"string","description":"Filter equal to any of the values. Multiple values can be specified by using a comma separated list."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"status":"OK","results":[{"taxonomy":"1.0","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","tertiary_category":"Performance management and accountability","secondary_category":"Organizational & Management"},{"taxonomy":"1.0","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","tertiary_category":"Compliance monitoring and reporting","secondary_category":"Data & Privacy"}],"request_id":"daac836f71724420b66011d55d88b30b"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VfmxH3gvSLtRfO21yXNHP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the complete list of risk factor classifications (primary, secondary, tertiary categories) used to categorize stock risk factors in SEC filings.","exampleAgentPrompt":"Can you pull the full list of risk factor categories and classifications used in Massive's stock risk factors endpoint, including all primary and secondary categories, sorted alphabetically?","exampleUseCases":[{"title":"Building risk factor filter UI","prompt":"I need to build a dropdown filter for our stock research tool — can you fetch all available risk factor categories from Massive so I know what primary and secondary classifications exist to offer as filter options?"},{"title":"Understanding SEC risk classification hierarchy","prompt":"What are all the top-level and mid-level risk categories used to classify risks in SEC filings on Massive? I want to understand the full taxonomy before I start querying actual risk factor data."},{"title":"Validating risk category values before querying","prompt":"Before I run a query on the risk factors endpoint, can you check what valid values exist for tertiary_category under the 'Regulatory' primary category so I know what to filter by?"}],"resultDescription":"A paginated list of risk factor taxonomy entries, each containing a taxonomy version number, primary category (top-level risk type), secondary category (mid-level classification), and tertiary category (most specific classification). Results are sortable and filterable by any category level or taxonomy version, with up to 1000 entries per call.","failureModes":["Invalid taxonomy version number returns empty results or 400 error","Misspelled category filter strings return no matches","Limit exceeding 1000 results in a validation error","Requesting a non-existent taxonomy version returns empty result set","Rate limiting or payment failure with x402 protocol returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to discover valid risk factor classification values before filtering or querying the main risk factors endpoint, when building filter UIs for stock risk analysis tools, or when you need to understand the hierarchical structure of risk categories across taxonomy versions. Prefer this over guessing category strings to avoid zero-result queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:48:27.486Z","isFirstParty":false}