ClousDocs
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}/insiders

Results 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

StatusMeaning
200Success. An empty result still returns 200 with data: [] and a warnings entry.
401Missing or invalid API key.
402Out of credits.
404No record for the supplied path parameter.
422Validation error — a parameter was the wrong type or out of range.
429Rate limited.

All data derives from public SEC EDGAR (and, where noted, FINRA IAPD / USPTO) filings. Clous is independent of the SEC.

On this page