Form N-PX API: how funds and managers voted their proxies
Form N-PX proxy voting records for funds and institutional managers as JSON: every vote cast, by meeting and proposal.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/n-px?size=2"
import os, requests
r = requests.get(
"https://secfeedapi.com/v1/n-px",
params={'size': '2'},
headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
)
print(r.json())Overview
Funds, and since 2024 institutional managers that file 13F, report every proxy vote they cast on Form N-PX: the company, meeting date, proposal, how they voted and how many shares. The structured XML format makes it possible to compare voting across managers.
The N-PX API returns each filing parsed with every field.
What you get
Built for developers who would rather not parse EDGAR.
Issuer, meeting date, proposal description, vote cast and shares voted.
Both registrants and institutional managers that file N-PX.
The full XML as JSON.
Endpoints
Authenticate with Authorization: Bearer YOUR_KEY. Responses are JSON.
Response fields
The main fields in every result. The raw filing data is always one level down.
| Field | Meaning |
|---|---|
accessionNo, formType, filedAt, cik, companyName | The filing and the filer. |
data.primary_doc.formData.coverPage | Report period and the reporting person. |
Use cases
- Compare say on pay votes across asset managers
- ESG and stewardship research
- Track support for shareholder proposals
Datasets behind this API
The SEC forms this API reads, with live filing counts.
Form N-PX proxy voting records of funds and, since 2024, institutional managers' say-on-pay votes: every ballot item and how it was voted.
13F-HRPortfolio holdingsEvery Form 13F-HR quarterly holdings report from institutional managers with $100M or more: positions by CUSIP, value, shares and voting authority.
FAQ
When is N-PX filed?
By August 31 each year, covering votes from July 1 through June 30.
Try the Proxy Voting Records free
500 API calls a month on the free plan. No sales call.