13F Holdings
Full reference for the live Clous 13F holdings endpoint — query institutional manager → security positions disclosed on Form 13F.
13F Holdings
The holdings endpoint exposes Form 13F institutional holdings, resolved to canonical managers and securities. Each record is one manager's reported position in a single security for a given reporting period.
- Base URL:
https://api.clous.ai - Auth:
Authorization: Bearer clous_live_...
List / search holdings
GET /v1/holdingsList and filter Form 13F holdings (manager → security positions). Results are returned through the standard envelope and are cursor-paginated.
Query parameters
Prop
Type
Example request
All reported holders of a CUSIP (here 037833100, Apple Inc.):
curl -s "https://api.clous.ai/v1/holdings?cusip=037833100&limit=2" \
-H "Authorization: Bearer clous_live_..."import requests
resp = requests.get(
"https://api.clous.ai/v1/holdings",
params={"cusip": "037833100", "limit": 2},
headers={"Authorization": "Bearer clous_live_..."},
)
resp.raise_for_status()
data = resp.json()const resp = await fetch(
"https://api.clous.ai/v1/holdings?cusip=037833100&limit=2",
{
headers: { Authorization: "Bearer clous_live_..." },
},
);
const data = await resp.json();Example response
{
"data": [
{
"manager_name": "VANGUARD GROUP INC",
"period": "31-DEC-2025",
"issuer": "APPLE INC",
"cusip": "037833100",
"value_usd": 347722995434,
"shares": 1279051701,
"shares_type": "SH",
"investment_discretion": "SOLE",
"accession": "0000102909-26-000031"
},
{
"manager_name": "VANGUARD GROUP INC",
"period": "31-DEC-2024",
"issuer": "APPLE INC",
"cusip": "037833100",
"value_usd": 332378393920,
"shares": 1327283739,
"shares_type": "SH",
"investment_discretion": "SOLE",
"accession": "0001752724-25-022205"
}
],
"page": {
"limit": 2,
"next_cursor": "MzMyMzc4MzkzOTIwfDAzNzgzMzEwMA",
"has_more": true
},
"as_of": "2026-06-12T04:10:28.996668Z",
"source": "form_13f",
"query_echo": {
"manager": null,
"cusip": "037833100",
"issuer": null,
"limit": 2
},
"warnings": []
}Each data record carries the manager (manager_name), the reporting period,
the security (issuer, cusip), the position (value_usd, shares,
shares_type, investment_discretion), and the source filing accession.
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 error semantics. |
402 | Out of credits. See error semantics. |
422 | Validation error — a parameter was the wrong type or out of range. |
429 | Rate limited. See rate limits. |
Notes
- All values derive from public SEC EDGAR — Form 13F filings. Clous is independent of the SEC.
- A holding is keyed by manager, security (CUSIP), and reporting
period, so a manager that has held a security across multiple quarters appears as one record per period. - Use
query_echoin 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.