API Reference
Company financials by CIK (XBRL facts)
Every XBRL-reported financial concept for one company, proxied live from SEC's company-facts API.
Company financials by CIK (XBRL facts)
Every XBRL-reported financial concept for one company, proxied live from SEC's company-facts API.
- Base URL:
https://api.clous.ai - Auth:
Authorization: Bearer clous_live_...
GET /v1/financials/{cik}Results are returned through the standard response envelope and are cursor-paginated.
This endpoint takes a path parameter (cik). Resolve it via /v1/filings or /v1/entities first.
Query parameters
Prop
Type
Example request
curl -s "https://api.clous.ai/v1/financials/320193" \
-H "Authorization: Bearer clous_live_..."import requests
resp = requests.get(
"https://api.clous.ai/v1/financials/320193",
params={},
headers={"Authorization": "Bearer clous_live_..."},
)
data = resp.json()const resp = await fetch(
"https://api.clous.ai/v1/financials/320193",
{ headers: { Authorization: "Bearer clous_live_..." } },
);
const data = await resp.json();Example response
{
"data": [
{
"concept": "us-gaap:WeightedAverageNumberOfSharesOutstandingBasic",
"label": "Weighted Average Number of Shares Outstanding, Basic",
"unit": "shares",
"value": 15037903000,
"fiscal_year": 2026,
"fiscal_period": "Q2",
"period_start": "2024-09-29",
"period_end": "2025-03-29",
"form": "10-Q",
"filed": "2026-05-01",
"accession": "0000320193-26-000013"
},
{
"concept": "us-gaap:WeightedAverageNumberOfSharesOutstandingBasic",
"label": "Weighted Average Number of Shares Outstanding, Basic",
"unit": "shares",
"value": 14994082000,
"fiscal_year": 2026,
"fiscal_period": "Q2",
"period_start": "2024-12-29",
"period_end": "2025-03-29",
"form": "10-Q",
"filed": "2026-05-01",
"accession": "0000320193-26-000013"
}
],
"page": {
"limit": 500,
"next_cursor": null,
"has_more": false
},
"as_of": "2026-06-13T16:27:34.433883Z",
"source": "edgar_xbrl",
"query_echo": {
"cik": "320193",
"entity_name": "Apple Inc.",
"concept": null,
"fact_count": 24852
},
"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.