API Reference
8-K event items
Classify the numbered items an 8-K reports against the canonical 8-K taxonomy, with excerpts.
8-K event items
Classify the numbered items an 8-K reports against the canonical 8-K taxonomy, with excerpts.
- Base URL:
https://api.clous.ai - Auth:
Authorization: Bearer clous_live_...
GET /v1/filings/{accession}/eventsResults are returned through the standard response envelope and are cursor-paginated.
This endpoint takes a path parameter (accession). Resolve it via /v1/filings or /v1/entities first.
Example request
curl -s "https://api.clous.ai/v1/filings/0000320193-25-000079/events" \
-H "Authorization: Bearer clous_live_..."import requests
resp = requests.get(
"https://api.clous.ai/v1/filings/0000320193-25-000079/events",
params={},
headers={"Authorization": "Bearer clous_live_..."},
)
data = resp.json()const resp = await fetch(
"https://api.clous.ai/v1/filings/0000320193-25-000079/events",
{ headers: { Authorization: "Bearer clous_live_..." } },
);
const data = await resp.json();Example response
{
"data": [
{
"accession": "0000320193-25-000079",
"cik": "0000320193",
"company_name": "Apple Inc.",
"form_type": "10-K",
"filed_at": "2025-10-31",
"items": [],
"events": [],
"document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
}
],
"page": {
"limit": 1,
"next_cursor": null,
"has_more": false
},
"as_of": "2026-06-13T16:27:32.827240Z",
"source": "edgar",
"query_echo": {
"accession": "0000320193-25-000079",
"item_count": 0
},
"warnings": [
"empty_result: no numbered 8-K items detected (pre-2004 form or non-8-K?)"
]
}Status codes
| Status | Meaning |
|---|---|
200 | Success. An empty result still returns 200 with data: [] and a warnings entry. |
401 | Missing or invalid API key. |
402 | Out of credits. |
404 | No record for the supplied path parameter. |
422 | Validation error — a parameter was the wrong type or out of range. |
429 | Rate limited. |
All data derives from public SEC EDGAR (and, where noted, FINRA IAPD / USPTO) filings. Clous is independent of the SEC.