GET /v1/events/voting-results

Retrieve structured shareholder-vote results from 8-K Item 5.07 filings

Audience: application and coding agent.

Coverage and source scope

Returns proposals, vote counts, and reported outcomes extracted from 8-K Item 5.07 disclosures for one issuer. It is not a universal proxy-voting archive: issuer identity is required, coverage is limited to eligible filings scanned, and proposal interpretation should retain the cited accession and source fields. Treat filing dates as disclosure dates and continue with the returned nextCursor value for the same filters. See API conventions.

Agent mode

Pass ?view=agent to receive the compact agent shape: event identifiers (ticker, form, filing date, accession number, meeting date, meeting type, and headline), the cited filing URL, and a compact proposal list. Vote-format detail, parser metadata, and the longer summary are omitted. See api conventions → response formats for the full ?view= contract.

Canonical metadata

requestId
traceparent
per-row provenance
per-row freshness
per-row materialization

Example request

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/events/voting-results?ticker=AAPL"

Example response

{
  "object": "list",
  "data": [],
  "hasMore": false,
  "nextCursor": null,
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Give this prompt to your agent

Failure posture

treat non-2xx responses as contract-aware failures, not free-form errors
preserve requestId and traceparent in logs and downstream reports
if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff

​Coverage and source scope

​Agent mode

​Canonical metadata

​Example request

​Example response

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Agent mode

Canonical metadata

Example request

Example response

Give this prompt to your agent

Failure posture