Ownership (13D/G)

The ownership endpoint exposes Schedule 13D / 13G beneficial-ownership filings — the SEC disclosures that surface large shareholders and activist stakes — resolved to canonical issuers and reporting persons. Each record is one reporting-person line on a 13D/13G filing.

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

List / search ownership records

GET /v1/ownership

List and filter 13D/13G beneficial-ownership records. Results are returned through the standard envelope and are cursor-paginated.

Query parameters

Example request

All ownership records for an issuer matching "tesla":

curl -s "https://api.clous.ai/v1/ownership?issuer=tesla&limit=2" \
  -H "Authorization: Bearer clous_live_..."

import requests

resp = requests.get(
    "https://api.clous.ai/v1/ownership",
    params={"issuer": "tesla", "limit": 2},
    headers={"Authorization": "Bearer clous_live_..."},
)
resp.raise_for_status()
data = resp.json()

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

Example response

{
  "data": [
    {
      "id": 65493,
      "accession": "0001104659-24-020124",
      "cik_filer": "1318605",
      "cik_subject": null,
      "issuer": "Tesla, Inc.",
      "person_name": "The Vanguard Group - 23-1945930",
      "role": "reporting_person",
      "form_type": "SC 13G/A",
      "filing_date": "2024-02-13",
      "source_url": "https://www.sec.gov/Archives/edgar/data/1318605/000110465924020124/0001104659-24-020124.txt",
      "observed_at": "2026-05-29T14:12:03"
    },
    {
      "id": 122687,
      "accession": "0001193125-23-067846",
      "cik_filer": "1318605",
      "cik_subject": null,
      "issuer": "Tesla, Inc.  (TSLA)",
      "person_name": "Elon R. Musk",
      "role": "reporting_person",
      "form_type": "SC 13G/A",
      "filing_date": "2023-03-13",
      "source_url": "https://www.sec.gov/Archives/edgar/data/1318605/000119312523067846/0001193125-23-067846.txt",
      "observed_at": "2026-05-29T17:33:32"
    }
  ],
  "page": {
    "limit": 2,
    "next_cursor": "MjAyMzAzMTN8MTIyNjg3",
    "has_more": true
  },
  "as_of": "2026-06-12T04:10:29.453831Z",
  "source": "ownership",
  "query_echo": {
    "issuer": "tesla",
    "limit": 2
  },
  "warnings": []
}

Status codes

Notes

• Records are 13D/13G beneficial-ownership lines — 13D/13D/A are activist (control-intent) filings, 13G/13G/A are passive. Use form_class to match a whole family or form_type for an exact form.
• role values are lowercase: reporting_person (the beneficial owner) or signatory.
• cik_subject (the issuer CIK) is sparse in the source data and is usually null — prefer the issuer substring filter to find a company's filings. Tickers are not populated as a structured field; when present they appear inline in the issuer string (e.g. "Tesla, Inc. (TSLA)").
• 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.