API Reference
Section extractor
Extract a named item (e.g. Risk Factors, MD&A) from a 10-K/10-Q/8-K primary document.
Section extractor
Extract a named item (e.g. Risk Factors, MD&A) from a 10-K/10-Q/8-K primary document.
- Base URL:
https://api.clous.ai - Auth:
Authorization: Bearer clous_live_...
GET /v1/filings/{accession}/extractResults 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.
Query parameters
Prop
Type
Example request
curl -s "https://api.clous.ai/v1/filings/0000320193-25-000079/extract?item=1A" \
-H "Authorization: Bearer clous_live_..."import requests
resp = requests.get(
"https://api.clous.ai/v1/filings/0000320193-25-000079/extract",
params={"item":"1A"},
headers={"Authorization": "Bearer clous_live_..."},
)
data = resp.json()const resp = await fetch(
"https://api.clous.ai/v1/filings/0000320193-25-000079/extract?item=1A",
{ headers: { Authorization: "Bearer clous_live_..." } },
);
const data = await resp.json();Example response
{
"data": [
{
"accession": "0000320193-25-000079",
"cik": "0000320193",
"form_type": "10-K",
"item": "1A",
"document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
"found": true,
"text": "Risk Factors \n The following summarizes factors that could have a material adverse effect on the Company's business, reputation, results of operations, financial condition and stock price. The Company may not be able to accurately predict, control or mitigate these risks. Statements in this section …",
"chars": 50000
}
],
"page": {
"limit": 1,
"next_cursor": null,
"has_more": false
},
"as_of": "2026-06-13T16:27:33.080486Z",
"source": "edgar",
"query_echo": {
"accession": "0000320193-25-000079",
"item": "1A"
},
"warnings": []
}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.