Home / Developers / Vote Results Feed
API reference

Vote Results Feed

Every 8-K that reports Item 5.07, where companies publish the results of shareholder votes: director elections, say on pay, auditor ratification and shareholder proposals. text=true returns the vote tables as plain text. Product overview →

Endpoints

/v1/form-8k/shareholder-votes

GEThttps://secfeedapi.com/v1/form-8k/shareholder-votes

8-K Item 5.07 feed with the item text.

ParameterTypeDescriptionExample
cikintegerFiler CIK. Ticker is not accepted here; look it up first with /v1/mapping/ticker.1045810
startDatestringEarliest filing date, YYYY-MM-DD, inclusive.2026-09-01
endDatestringLatest filing date, YYYY-MM-DD, inclusive.2026-09-30
fromintegerOffset of the first row to return, for paging. Default 0.20
sizeintegerRows per page. Capped at 100. Default 20.10
textstringtrue adds the text of this item from the filing; false returns metadata only and is faster. Default true.false

/v1/form-8k

GEThttps://secfeedapi.com/v1/form-8k

8-K filings classified by item, with item text on request.

ParameterTypeDescriptionExample
itemstring8-K item number with a dot, for example 1.01, 2.02 or 5.07. Omit to get every 8-K.4.01
cikintegerFiler CIK.1045810
startDatestringEarliest filing date, YYYY-MM-DD.2026-09-01
endDatestringLatest filing date, YYYY-MM-DD.2026-09-30
fromintegerOffset of the first row to return, for paging. Default 0.20
sizeintegerRows per page. Capped at 100. Default 50.25
textstringtrue adds the item's text. Only applies when item is set. Default false.true

Request examples

Every response below is real output from the API, trimmed to the first records.

Latest vote results with text

The two newest Item 5.07 filings with the results text.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/form-8k/shareholder-votes?size=2"
import os, requests

r = requests.get(
    "https://secfeedapi.com/v1/form-8k/shareholder-votes",
    params={'size': '2'},
    headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
    timeout=60,
)
r.raise_for_status()
print(r.json())
{
  "total": 20799,
  "filings": [
    {
      "accession": "0001104659-26-115141",
      "cik": 2062583,
      "company": "MiniMed Group, Inc.",
      "form": "8-K",
      "filed": "2026-10-13",
      "period": "2026-10-09",
      "items": [
        {
          "item": "5.07",
          "title": "Submission of Matters to a Vote of Security Holders"
        },
        {
          "item": "9.01",
          "title": "Financial Statements and Exhibits"
        }
      ],
      "url": "https://www.sec.gov/Archives/edgar/data/2062583/000110465926115141/0001104659-26-115141-index.htm",
      "text": "Item 5.07\n Submission of Matters to a Vote of Security Holders.\n\nMiniMed Group, Inc. (the “Company”)\nheld its 2026 Annual Meeting of Stockholders on October 9, 2026 (the “Annual Meeting”), at which stockholders voted on the\nfollowing four proposals. All matters voted on at the An..."
    },
    {
      "accession": "0001104659-26-115162",
      "cik": 1852019,
      "company": "IX Acquisition Corp.",
      "form": "8-K",
      "filed": "2026-10-13",
      "period": "2026-10-07",
      "items": [
        {
          "item": "5.07",
          "title": "Submission of Matters to a Vote of Security Holders"
        },
        {
          "item": "8.01",
          "title": "Other Events"
        }
      ],
      "url": "https://www.sec.gov/Archives/edgar/data/1852019/000110465926115162/0001104659-26-115162-index.htm",
      "text": "Item\n5.07. Submission of Matters to a Vote of Security Holders.\n\nOn\nOctober 7, 2026, IX Acquisition Corp. (the “Company”) convened and then adjourned its extraordinary general meeting\nin lieu of an annual general meeting of the shareholders (the “Meeting”) to October 9, 2025 at 1..."
    }
  ]
}

Vote results for one company

Apple's recent Item 5.07 filings, typically one per annual meeting.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/form-8k/shareholder-votes?cik=320193&size=2"
import os, requests

r = requests.get(
    "https://secfeedapi.com/v1/form-8k/shareholder-votes",
    params={'cik': '320193', 'size': '2'},
    headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
    timeout=60,
)
r.raise_for_status()
print(r.json())
{
  "total": 3,
  "filings": [
    {
      "accession": "0001140361-26-006577",
      "cik": 320193,
      "company": "Apple Inc.",
      "form": "8-K",
      "filed": "2026-02-24",
      "period": "2026-02-24",
      "items": [
        {
          "item": "5.07",
          "title": "Submission of Matters to a Vote of Security Holders"
        },
        {
          "item": "9.01",
          "title": "Financial Statements and Exhibits"
        }
      ],
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126006577/0001140361-26-006577-index.htm",
      "text": "Item 5.07\n\nSubmission of Matters to a Vote of Security Holders.\n\nThe 2026 Annual Meeting of Shareholders (the “Annual Meeting”) of Apple Inc. (“Apple”) was held on February 24, 2026. At the Annual Meeting, Apple’s shareholders voted on the following five proposals and cast their..."
    },
    {
      "accession": "0001140361-25-005876",
      "cik": 320193,
      "company": "Apple Inc.",
      "form": "8-K",
      "filed": "2025-02-25",
      "period": "2025-02-25",
      "items": [
        {
          "item": "5.07",
          "title": "Submission of Matters to a Vote of Security Holders"
        }
      ],
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036125005876/0001140361-25-005876-index.htm",
      "text": "Item 5.07\n\nSubmission of Matters to a Vote of Security Holders.\n\nThe 2025 Annual Meeting of Shareholders (the “Annual Meeting”) of Apple Inc. (“Apple”) was held on February 25, 2025. At the Annual Meeting, Apple’s shareholders voted on the following seven proposals and cast their..."
    }
  ]
}

Vote results filed in a month, metadata only

Use total to size the month and page through rows.

curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/form-8k/shareholder-votes?startDate=2026-09-01&endDate=2026-09-30&text=false&size=5"
import os, requests

r = requests.get(
    "https://secfeedapi.com/v1/form-8k/shareholder-votes",
    params={'startDate': '2026-09-01', 'endDate': '2026-09-30', 'text': 'false', 'size': '5'},
    headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
    timeout=60,
)
r.raise_for_status()
print(r.json())
{
  "total": 215,
  "filings": [
    {
      "accession": "0000918541-26-000100",
      "cik": 918541,
      "company": "NN INC",
      "form": "8-K",
      "filed": "2026-09-30",
      "period": "2026-09-30",
      "items": [
        {
          "item": "5.03",
          "title": "Amendments to Articles or Bylaws"
        },
        {
          "item": "5.07",
          "title": "Submission of Matters to a Vote of Security Holders"
        }
      ],
      "url": "https://www.sec.gov/Archives/edgar/data/918541/000091854126000100/0000918541-26-000100-index.htm"
    },
    {
      "accession": "0001104659-26-112083",
      "cik": 1368622,
      "company": "AeroVironment Inc",
      "form": "8-K",
      "filed": "2026-09-30",
      "period": "2026-09-24",
      "items": [
        {
          "item": "5.07",
          "title": "Submission of Matters to a Vote of Security Holders"
        }
      ],
      "url": "https://www.sec.gov/Archives/edgar/data/1368622/000110465926112083/0001104659-26-112083-index.htm"
    }
  ]
}

Response fields

FieldTypeMeaning
totalintegerNumber of 8-K filings that match, across all pages.
filings[]arrayOne object per 8-K filing, newest first.
filings[].accessionstringEDGAR accession number.
filings[].cikintegerFiler CIK.
filings[].companystringFiler name as it appears in the EDGAR index.
filings[].formstring8-K or 8-K/A.
filings[].filedstringDate EDGAR accepted the filing, YYYY-MM-DD.
filings[].periodstringDate of the earliest event reported, YYYY-MM-DD.
filings[].items[]arrayEvery item the filing reports, not only the one you filtered on.
filings[].items[].itemstringItem number, for example 9.01.
filings[].items[].titlestringOfficial item title.
filings[].urlstringURL of the filing index page on sec.gov.
filings[].textstringText of the requested item, when text=true. null if it could not be extracted.
filings[].textErrorstringPresent only when text extraction failed, with the reason.

8-K items you can filter on

ItemTitle
1.01Entry into a Material Definitive Agreement
1.02Termination of a Material Definitive Agreement
1.03Bankruptcy or Receivership
1.05Material Cybersecurity Incidents
2.01Completion of Acquisition or Disposition of Assets
2.02Results of Operations and Financial Condition
2.03Creation of a Direct Financial Obligation
2.05Costs Associated with Exit or Disposal Activities
2.06Material Impairments
3.01Notice of Delisting or Failure to Satisfy a Listing Rule
3.02Unregistered Sales of Equity Securities
4.01Changes in Registrant's Certifying Accountant
4.02Non-Reliance on Previously Issued Financial Statements
5.02Departure or Appointment of Directors or Officers
5.03Amendments to Articles or Bylaws
5.07Submission of Matters to a Vote of Security Holders
7.01Regulation FD Disclosure
8.01Other Events
9.01Financial 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

See also the error codes every endpoint shares.

Try it with your own key

500 free calls a month.

Get free API key →