Endpoints
/v1/form-8k/shareholder-votes
https://secfeedapi.com/v1/form-8k/shareholder-votes8-K Item 5.07 feed with the item text.
| Parameter | Type | Description | Example |
|---|---|---|---|
cik | integer | Filer CIK. Ticker is not accepted here; look it up first with /v1/mapping/ticker. | 1045810 |
startDate | string | Earliest filing date, YYYY-MM-DD, inclusive. | 2026-09-01 |
endDate | string | Latest filing date, YYYY-MM-DD, inclusive. | 2026-09-30 |
from | integer | Offset of the first row to return, for paging. Default 0. | 20 |
size | integer | Rows per page. Capped at 100. Default 20. | 10 |
text | string | true adds the text of this item from the filing; false returns metadata only and is faster. Default true. | false |
- Every 8-K that reports Item 5.07 (Submission of Matters to a Vote of Security Holders), newest first.
- Text is included by default; pass text=false for fast metadata-only pages.
/v1/form-8k
https://secfeedapi.com/v1/form-8k8-K filings classified by item, with item text on request.
| Parameter | Type | Description | Example |
|---|---|---|---|
item | string | 8-K item number with a dot, for example 1.01, 2.02 or 5.07. Omit to get every 8-K. | 4.01 |
cik | integer | Filer CIK. | 1045810 |
startDate | string | Earliest filing date, YYYY-MM-DD. | 2026-09-01 |
endDate | string | Latest filing date, YYYY-MM-DD. | 2026-09-30 |
from | integer | Offset of the first row to return, for paging. Default 0. | 20 |
size | integer | Rows per page. Capped at 100. Default 50. | 25 |
text | string | true adds the item's text. Only applies when item is set. Default false. | true |
- Newest filings first.
- The item index is being backfilled toward 2004; the earliest filed date in a result shows current coverage.
Request examples
Every response below is real output from the API, trimmed to the first records.
Response fields
| Field | Type | Meaning |
|---|---|---|
total | integer | Number of 8-K filings that match, across all pages. |
filings[] | array | One object per 8-K filing, newest first. |
filings[].accession | string | EDGAR accession number. |
filings[].cik | integer | Filer CIK. |
filings[].company | string | Filer name as it appears in the EDGAR index. |
filings[].form | string | 8-K or 8-K/A. |
filings[].filed | string | Date EDGAR accepted the filing, YYYY-MM-DD. |
filings[].period | string | Date of the earliest event reported, YYYY-MM-DD. |
filings[].items[] | array | Every item the filing reports, not only the one you filtered on. |
filings[].items[].item | string | Item number, for example 9.01. |
filings[].items[].title | string | Official item title. |
filings[].url | string | URL of the filing index page on sec.gov. |
filings[].text | string | Text of the requested item, when text=true. null if it could not be extracted. |
filings[].textError | string | Present only when text extraction failed, with the reason. |
8-K items you can filter on
| Item | Title |
|---|---|
| 1.01 | Entry into a Material Definitive Agreement |
| 1.02 | Termination of a Material Definitive Agreement |
| 1.03 | Bankruptcy or Receivership |
| 1.05 | Material Cybersecurity Incidents |
| 2.01 | Completion of Acquisition or Disposition of Assets |
| 2.02 | Results of Operations and Financial Condition |
| 2.03 | Creation of a Direct Financial Obligation |
| 2.05 | Costs Associated with Exit or Disposal Activities |
| 2.06 | Material Impairments |
| 3.01 | Notice of Delisting or Failure to Satisfy a Listing Rule |
| 3.02 | Unregistered Sales of Equity Securities |
| 4.01 | Changes in Registrant's Certifying Accountant |
| 4.02 | Non-Reliance on Previously Issued Financial Statements |
| 5.02 | Departure or Appointment of Directors or Officers |
| 5.03 | Amendments to Articles or Bylaws |
| 5.07 | Submission of Matters to a Vote of Security Holders |
| 7.01 | Regulation FD Disclosure |
| 8.01 | Other Events |
| 9.01 | Financial Statements and Exhibits |
How to
How do I get a company's latest say on pay result?
Fetch its newest Item 5.07 filing with text and look for the advisory compensation vote in the text.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/shareholder-votes?cik=320193&size=1"
How do I link a vote result to the proxy that proposed it?
Use the Shareholder Meetings API for the same company; it lists ballot items and the 5.07 filings together.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/shareholder-meetings?ticker=AAPL"
How do I list all vote results in proxy season?
Use a date range with text=false and page through.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/shareholder-votes?startDate=2026-05-01&endDate=2026-06-30&text=false&size=100"
Why do some rows list other items too?
One 8-K can report several items, for example a vote result and a director change. items lists everything the filing covers.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/shareholder-votes?text=false&size=20"
How do I get special meeting results?
They are also reported under Item 5.07; the text names the meeting type.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/shareholder-votes?size=5"
How do I get only the metadata quickly?
Pass text=false.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/shareholder-votes?text=false&size=10"
How do I reach rows beyond the first page?
Combine size and from.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/shareholder-votes?text=false&size=50&from=50"
How do I read the vote table exactly as filed?
Open url, or pass it to the PDF Generator for an archival copy.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/shareholder-votes?size=1&text=false"
Errors
- 400 when size or from is not a number.
- Item text can be null with a textError when the filing's layout hides the item heading.
See also the error codes every endpoint shares.
Try it with your own key
500 free calls a month.