ClousDocs
API Reference

Insider (Form 4)

Full reference for the live Clous insider-transactions endpoint — search Form 3/4/5 insider trades by issuer, owner, transaction code, date, and value.

Insider (Form 4)

The insider endpoint exposes Form 3/4/5 insider-transaction reports — purchases, sales, grants, exercises, and dispositions by an issuer's officers, directors, and 10% owners — resolved to canonical issuer and owner entities.

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

List / search insider transactions

GET /v1/insider

List and filter Form 3/4/5 insider transactions. Results are returned through the standard envelope and are cursor-paginated.

Query parameters

Prop

Type

Example request

Most recent insider transactions for Apple (AAPL):

curl -s "https://api.clous.ai/v1/insider?ticker=AAPL&limit=2" \
  -H "Authorization: Bearer clous_live_..."
import requests

resp = requests.get(
    "https://api.clous.ai/v1/insider",
    params={"ticker": "AAPL", "limit": 2},
    headers={"Authorization": "Bearer clous_live_..."},
)
resp.raise_for_status()
data = resp.json()
const resp = await fetch(
  "https://api.clous.ai/v1/insider?ticker=AAPL&limit=2",
  {
    headers: { Authorization: "Bearer clous_live_..." },
  },
);
const data = await resp.json();

Example response

{
  "data": [
    {
      "accession": "0001780525-26-000005",
      "issuer_cik": "0000320193",
      "issuer_name": "Apple Inc.",
      "ticker": "AAPL",
      "owner_cik": "0001780525",
      "owner_name": "Newstead Jennifer",
      "owner_relationship": "Officer",
      "trans_code": "M",
      "acquired_disposed": "D",
      "derivative": true,
      "security_title": "Restricted Stock Unit",
      "shares": 60208,
      "price_per_share": 0.0,
      "value_usd": 0,
      "shares_owned_after": 240832,
      "trans_date": "2026-03-15",
      "filing_date": "2026-03-17"
    },
    {
      "accession": "0001780525-26-000005",
      "issuer_cik": "0000320193",
      "issuer_name": "Apple Inc.",
      "ticker": "AAPL",
      "owner_cik": "0001780525",
      "owner_name": "Newstead Jennifer",
      "owner_relationship": "Officer",
      "trans_code": "F",
      "acquired_disposed": "D",
      "derivative": false,
      "security_title": "Common Stock",
      "shares": 32528,
      "price_per_share": 250.12,
      "value_usd": 8135903,
      "shares_owned_after": 27680,
      "trans_date": "2026-03-15",
      "filing_date": "2026-03-17"
    }
  ],
  "page": {
    "limit": 2,
    "next_cursor": "MjAyNjAzMTV8MDAwMTc4MDUyNS0yNi0wMDAwMDU",
    "has_more": true
  },
  "as_of": "2026-06-12T04:10:29.307657Z",
  "source": "insider",
  "query_echo": {
    "ticker": "AAPL",
    "limit": 2
  },
  "warnings": []
}

Each record is one reported transaction line. The same accession can appear on multiple rows when a Form 4 reports several transactions. Records carry the resolved issuer (issuer_cik, issuer_name, ticker) and owner (owner_cik, owner_name, owner_relationship) plus the trade details (trans_code, shares, price_per_share, value_usd, shares_owned_after).

Status codes

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

Notes

  • All values derive from public SEC EDGAR — Form 3/4/5 insider filings. Clous is independent of the SEC.
  • acquired_disposed is single-letter A / D; trans_code is the SEC's single-letter transaction code (e.g. P, S, A, M, F, D, G).
  • For award and exercise legs (A, M), price_per_share and value_usd are commonly 0 because no cash changes hands — use trans_code=P and min_value_usd to isolate cash open-market trades.
  • Filtering by issuer_cik is the fastest query, since it is the primary sort key.
  • 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.

Financials (XBRL)

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

Ownership (13D/G)

Full reference for the live Clous ownership endpoint — search 13D/13G beneficial-ownership records and activist stakes by issuer, filer, person, form type, and filing date.

On this page

Insider (Form 4)List / search insider transactionsQuery parametersExample requestExample responseStatus codesNotes