API Reference
Insider filing detail (3/4/5)
Full structured parse of one Form 3/4/5 ownership filing — owners, every trade, holdings, footnotes.
Insider filing detail (3/4/5)
Full structured parse of one Form 3/4/5 ownership filing — owners, every trade, holdings, footnotes.
- Base URL:
https://api.clous.ai - Auth:
Authorization: Bearer clous_live_...
GET /v1/filings/{accession}/insidersResults 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/0001140361-26-020871/insiders" \
-H "Authorization: Bearer clous_live_..."import requests
resp = requests.get(
"https://api.clous.ai/v1/filings/0001140361-26-020871/insiders",
params={},
headers={"Authorization": "Bearer clous_live_..."},
)
data = resp.json()const resp = await fetch(
"https://api.clous.ai/v1/filings/0001140361-26-020871/insiders",
{ headers: { Authorization: "Bearer clous_live_..." } },
);
const data = await resp.json();Example response
{
"data": [
{
"accession": "0001140361-26-020871",
"form_type": "4",
"document_type": "4",
"period_of_report": "2026-05-08",
"not_subject_to_section16": null,
"filed_at": "2026-05-12",
"issuer": {
"cik": "0000320193",
"name": "Apple Inc.",
"ticker": "AAPL"
},
"reporting_owners": [
{
"name": "Borders Ben",
"cik": "0002100523",
"is_director": false,
"is_officer": true,
"is_ten_percent_owner": false,
"is_other": false,
"officer_title": "Principal Accounting Officer",
"other_text": null,
"address": {
"street1": "ONE APPLE PARK WAY",
"street2": null,
"city": "CUPERTINO",
"state": "CA",
"zip_code": "95014"
}
}
],
"transactions": [
{
"derivative": false,
"security": "Common Stock",
"date": "2026-05-08",
"code": "S",
"equity_swap_involved": false,
"shares": "1274",
"price_per_share": "290",
"acquired_disposed": "D",
"shares_owned_after": "38713",
"direct_or_indirect": "D",
"nature_of_ownership": null,
"transaction_type": "Open-market or private sale",
"value": 369460
}
],
"holdings": [],
"footnotes": [
{
"id": "F1",
"text": "This transaction was made pursuant to a Rule 10b5-1 trading plan adopted by the reporting person on February 6, 2026."
}
],
"owner_signature_name": "/s/ Sam Whittington, Attorney-in-Fact for Ben Borders",
"owner_signature_date": "2026-05-12",
"document_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126020871/form4.xml"
}
],
"page": {
"limit": 1,
"next_cursor": null,
"has_more": false
},
"as_of": "2026-06-13T16:27:33.398369Z",
"source": "edgar_ownership",
"query_echo": {
"accession": "0001140361-26-020871",
"transaction_count": 1,
"holding_count": 0
},
"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.