{"uid":"cap_CuckR6K3bfxiOLEvfmogi","slug":"disclosure-categories-taxonomy-e5db4328","name":"Disclosure Categories Taxonomy","description":"The complete list of 8-K disclosure classifications used in the 8-K disclosures endpoint. Can't find what you're looking for? POST feedback to /feedback, no charge.","url":"https://agent.massive.com/stocks/taxonomies/vX/disclosures","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":"string","description":"Taxonomy version that defines this classification (e.g., '1.0')."},"taxonomy.gt":{"type":"string","description":"Filter greater than the value."},"taxonomy.lt":{"type":"string","description":"Filter less than the value."},"taxonomy.gte":{"type":"string","description":"Filter greater than or equal to the value."},"taxonomy.lte":{"type":"string","description":"Filter less than or equal to the value."},"taxonomy.any_of":{"type":"string","description":"Filter equal to any of the values. Multiple values can be specified by using a comma separated list."},"primary_category":{"type":"string","description":"Top-level disclosure category."},"tertiary_category":{"type":"string","description":"Most specific disclosure category."},"secondary_category":{"type":"string","description":"Mid-level disclosure 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":"New CEO appointment with background, employment terms, and compensation.","primary_category":"leadership_and_governance","tertiary_category":"ceo_appointment","secondary_category":"executive_leadership"},{"taxonomy":"1.0","description":"Quarterly financial results including revenue, net income, EPS, and key operating metrics with management commentary.","primary_category":"financial_results","tertiary_category":"quarterly_earnings","secondary_category":"earnings_and_performance"}],"request_id":"a1b2c3d4e5f6a7b8c9d0e1f2"}},"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_koMM5YGWMsXGCj_SJGKma","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 8-K disclosure classifications (primary, secondary, and tertiary categories) used to categorize SEC 8-K filings.","exampleAgentPrompt":"Pull the full list of 8-K disclosure categories from Massive's taxonomy, sorted by taxonomy version descending, so I can see every primary, secondary, and tertiary classification label available.","exampleUseCases":[{"title":"Building 8-K disclosure filter UI","prompt":"Give me all the available 8-K disclosure categories from Massive's taxonomy so I can populate the filter dropdowns in my disclosure monitoring dashboard — I need all primary, secondary, and tertiary labels."},{"title":"Validating disclosure category labels","prompt":"I'm processing 8-K filings and need to validate that the category labels I'm seeing are official — can you pull the complete list of Massive's disclosure classifications so I can cross-check them?"},{"title":"Exploring taxonomy for a specific primary category","prompt":"Show me all the disclosure subcategories under the primary category 'Mergers and Acquisitions' in Massive's 8-K taxonomy so I can understand how that section breaks down into secondary and tertiary labels."}],"resultDescription":"A paginated list of disclosure classification records, each containing a taxonomy version, primary category, secondary category, and tertiary category label. Results are sortable and filterable by any category level or taxonomy version, with up to 1000 records per response.","failureModes":["Invalid filter value returns empty result set rather than an error","Exceeding limit of 1000 returns a validation error","Unknown sort column causes a 400 bad request","Payment not provided or insufficient USDC results in a 402 Payment Required response","Taxonomy version filter with no matching records returns an empty list"],"whenToPreferThis":"Use this endpoint when you need to understand or enumerate the classification schema for 8-K disclosures before querying the actual 8-K disclosures endpoint. It is the authoritative reference for valid category values, useful for building filters, validating labels, or exploring how disclosures are hierarchically organized. Prefer this over the 8-K disclosures endpoint when you need the taxonomy structure itself rather than actual filing data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:47:00.886Z","isFirstParty":false}