Full reference for the live Clous filings endpoint — search the SEC EDGAR filing index across every form type.

Filings

The filings endpoint exposes the SEC EDGAR filing index across all form types (10-K, 10-Q, 8-K, Form 4, 13F-HR, SC 13G, Form D, and more), resolved to canonical filer entities. Each record describes one filing — who filed it, when, the form type, and its accession number — with provenance back to EDGAR.

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

Search filings

GET /v1/filings

Search and filter the SEC EDGAR filing index. Results are returned through the standard envelope and are cursor-paginated.

Query parameters

Prop

Type

Example request

The two most recent Tesla 8-K filings:

curl -s "https://api.clous.ai/v1/filings?q=tesla&form_type=8-K&limit=2" \
  -H "Authorization: Bearer clous_live_..."

import requests

resp = requests.get(
    "https://api.clous.ai/v1/filings",
    params={"q": "tesla", "form_type": "8-K", "limit": 2},
    headers={"Authorization": "Bearer clous_live_..."},
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch(
  "https://api.clous.ai/v1/filings?q=tesla&form_type=8-K&limit=2",
  {
    headers: { Authorization: "Bearer clous_live_..." },
  },
);
const data = await resp.json();
console.log(data);

Example response

{
  "data": [
    {
      "cik": "0001318605",
      "company_name": "Tesla, Inc.",
      "form_type": "8-K",
      "filed_at": "2026-04-22",
      "report_date": "2026-04-22",
      "accession": "0001628280-26-026551",
      "act": "34",
      "file_number": "001-34756",
      "film_number": "26883889",
      "primary_document": "tsla-20260422.htm",
      "primary_doc_desc": "8-K",
      "size_bytes": 5825753,
      "is_xbrl": true,
      "is_inline_xbrl": true,
      "acceptance_dt": "2026-04-22T20:10:44",
      "entity_type": "operating",
      "sic": "3711",
      "sic_description": "Motor Vehicles & Passenger Car Bodies",
      "state_of_incorp": "TX",
      "filed_year": 2026
    },
    {
      "cik": "0001318605",
      "company_name": "Tesla, Inc.",
      "form_type": "8-K",
      "filed_at": "2026-04-02",
      "report_date": "2026-04-02",
      "accession": "0001628280-26-022956",
      "act": "34",
      "file_number": "001-34756",
      "film_number": "26830913",
      "primary_document": "tsla-20260402.htm",
      "primary_doc_desc": "8-K",
      "size_bytes": 156981,
      "is_xbrl": true,
      "is_inline_xbrl": true,
      "acceptance_dt": "2026-04-02T13:07:13",
      "entity_type": "operating",
      "sic": "3711",
      "sic_description": "Motor Vehicles & Passenger Car Bodies",
      "state_of_incorp": "TX",
      "filed_year": 2026
    }
  ],
  "page": {
    "limit": 2,
    "next_cursor": "MjAyNjA0MDJ8MDAwMTYyODI4MC0yNi0wMjI5NTY",
    "has_more": true
  },
  "as_of": "2026-06-12T04:10:29.185194Z",
  "source": "filings",
  "query_echo": {
    "form_type": "8-K",
    "q": "tesla",
    "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 — the account has no remaining quota.
`422`	Validation error — a parameter was the wrong type or out of range.
`429`	Rate limited. See rate limits.

Notes

form_type is case-sensitive and must match the SEC form code exactly as filed (e.g. 8-K, 10-K, 13F-HR, D).
cik must be the 10-digit zero-padded CIK, e.g. 0000320193 for Apple.
Date filters (filed_from, filed_to) are inclusive ISO YYYY-MM-DD bounds on the filing date.
All values derive from public SEC EDGAR filings. Clous is independent of the SEC.
Use query_echo in the response to confirm exactly which typed parameters Clous applied to your request.
For paging through large result sets, follow page.next_cursor — see Pagination, Errors & Rate limits.

Filings

Filings

Search filings

Query parameters

Example request

Example response

Status codes

Notes

On this page