API Reference
Proxy Officers (DEF 14A)
Full reference for the live Clous DEF 14A endpoint — list/search the officers and directors disclosed in proxy statements, resolved to issuer entities.
Proxy Officers (DEF 14A)
The proxy-officers endpoint exposes the officers and directors disclosed in DEF 14A proxy statements, joined to the canonical issuer entity by CIK.
- Base URL:
https://api.clous.ai - Auth:
Authorization: Bearer clous_live_...
List / search proxy officers
GET /v1/proxy/officersList and filter officers and directors drawn from DEF 14A filings. Results are returned through the standard envelope and are cursor-paginated.
Query parameters
Prop
Type
Example request
Officers and directors at issuers whose name contains "blackrock":
curl -s "https://api.clous.ai/v1/proxy/officers?issuer=blackrock&limit=2" \
-H "Authorization: Bearer clous_live_..."import requests
resp = requests.get(
"https://api.clous.ai/v1/proxy/officers",
params={"issuer": "blackrock", "limit": 2},
headers={"Authorization": "Bearer clous_live_..."},
)
resp.raise_for_status()
data = resp.json()const resp = await fetch(
"https://api.clous.ai/v1/proxy/officers?issuer=blackrock&limit=2",
{
headers: { Authorization: "Bearer clous_live_..." },
}
);
const data = await resp.json();Example response
{
"data": [
{
"id": 567389,
"accession_number": "0001193125-26-253640",
"cik": "1528437",
"issuer_name": "BlackRock Municipal 2030 Target Term Trust",
"full_name": "Biographical Information Chart",
"title": "Officer or Director",
"age": null,
"tenure_years": null,
"is_independent": false,
"observed_at": "2026-06-02T00:00:00"
},
{
"id": 567327,
"accession_number": "0001193125-26-253620",
"cik": "891038",
"issuer_name": "BLACKROCK MUNIYIELD PENNSYLVANIA QUALITY FUND",
"full_name": "Biographical Information Chart",
"title": "Chief Financial Officer",
"age": null,
"tenure_years": null,
"is_independent": false,
"observed_at": "2026-06-02T00:00:00"
}
],
"page": {
"limit": 2,
"next_cursor": "MjAyNjA2MDJ8NTY3MzI3",
"has_more": true
},
"as_of": "2026-06-12T04:10:30.161765Z",
"source": "proxy",
"query_echo": {
"issuer": "blackrock",
"limit": 2
},
"warnings": []
}Each data record carries the row id, the DEF 14A accession_number, the
issuer cik and issuer_name, the person's full_name / title, optional
age and tenure_years, the is_independent flag, and observed_at.
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 errors. |
402 | Out of credits. See errors. |
422 | Validation error — a parameter was the wrong type or out of range. |
429 | Rate limited. See rate limits. |
Notes
- Proxy disclosures are extracted as filed, so
full_name,title,age, andtenure_yearsreflect the filing's own wording and may be sparse —ageandtenure_yearsare frequentlynull, and some rows carry section headings (e.g. "Biographical Information Chart") rather than a single named person. - Use
query_echoin the response to confirm exactly which typed parameters Clous applied to your request. - All data derives from public SEC EDGAR — DEF 14A filings; Clous is independent of the SEC.
- For paging through large result sets, follow
page.next_cursor— see Pagination, Errors & Rate limits.