Full reference for the live Clous Financials endpoint — query company XBRL financial facts from SEC filings by CIK, concept, form, period, and more.

Financials (XBRL)

The financials endpoint exposes XBRL company financial facts extracted from SEC filings — each record is a single tagged value (a concept, its value, unit, reporting period, and the form it was reported on), resolved to the canonical filer entity.

Base URL: https://api.clous.ai
Auth: Authorization: Bearer clous_live_...

List / search financial facts

GET /v1/financials

List and filter XBRL financial facts. Results are returned through the standard envelope and are cursor-paginated.

Query parameters

Prop

Type

Example request

Most recent financial facts for filers matching "jpmorgan":

curl -s "https://api.clous.ai/v1/financials?q=jpmorgan&limit=2" \
  -H "Authorization: Bearer clous_live_..."

import requests

resp = requests.get(
    "https://api.clous.ai/v1/financials",
    params={"q": "jpmorgan", "limit": 2},
    headers={"Authorization": "Bearer clous_live_..."},
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch(
  "https://api.clous.ai/v1/financials?q=jpmorgan&limit=2",
  {
    headers: { Authorization: "Bearer clous_live_..." },
  },
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
console.log(data);

Example response

{
  "data": [
    {
      "id": 25559,
      "cik": "0000019617",
      "entity_name": "JPMORGAN CHASE & CO",
      "sic": null,
      "ticker": null,
      "concept": "ffd:NrrtvMaxAggtOfferingPric",
      "value": 4030000,
      "unit": "USD",
      "period_start": null,
      "period_end": "2026-05-29",
      "fiscal_year": 2026,
      "form": "424B2",
      "accession": "0001918704-26-014671",
      "filed": "2026-05-29",
      "observed_at": "2026-05-31T09:48:31"
    },
    {
      "id": 25558,
      "cik": "0000019617",
      "entity_name": "JPMORGAN CHASE & CO",
      "sic": null,
      "ticker": null,
      "concept": "ffd:NrrtvMaxAggtOfferingPric",
      "value": 3821000,
      "unit": "USD",
      "period_start": null,
      "period_end": "2026-05-29",
      "fiscal_year": 2026,
      "form": "424B2",
      "accession": "0001918704-26-014670",
      "filed": "2026-05-29",
      "observed_at": "2026-05-31T09:48:31"
    }
  ],
  "page": {
    "limit": 2,
    "next_cursor": "MjAyNjA1Mjl8MjU1NTg",
    "has_more": true
  },
  "as_of": "2026-06-12T04:10:30.040708Z",
  "source": "financials",
  "query_echo": {
    "q": "jpmorgan",
    "limit": 2
  },
  "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. See errors.
`402`	Out of credits — top up to continue. See errors.
`422`	Validation error — a parameter was the wrong type or out of range.
`429`	Rate limited — back off and retry. See rate limits.

Notes

ticker is unpopulated in the source data and is typically null. For reliable filtering, use cik (exact, zero-padded 10-digit) or concept / concept_q rather than ticker.
Each record is a single XBRL fact: a concept tag, its value and unit, the reporting period (period_start / period_end), and the form and accession it was reported on.
Use query_echo in the response to confirm exactly which typed parameters Clous applied to your request.
All data derives from public SEC EDGAR filings. Clous is independent of the SEC.
For paging through large result sets, follow page.next_cursor — see Pagination, Errors & Rate limits.

Financials (XBRL)

Financials (XBRL)

List / search financial facts

Query parameters

Example request

Example response

Status codes

Notes

On this page