KeyVex Proxy Filings API

The Proxy Filings API from KeyVex — 1 operation(s) for proxy filings.

GitHub OpenAPI

Operations 1

GET /v1/proxy-filings Returns Schedule 14A proxy filings — the document public companies send… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/keyvex-com:keyvex-com-proxy-filings-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

keyvex-com-proxy-filings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KeyVex Proxy Filings API
  version: 0.102.0
  termsOfService: https://keyvex.com/terms
  description: 'US public financial-disclosure data — congressional trades, insider filings (Form 4), lobbying, Treasury auctions, member profiles. Requires an API key — create a free one at https://keyvex.com and send it as the header `x-api-key: `. A free key returns most public-record datasets (one year of history; no market-price data and a few heavy datasets are on paid plans only), capped at 60 requests/day; paid plans raise the caps. The daily allowance resets at midnight Eastern.'
servers:
- url: https://api.keyvex.com
security:
- ApiKeyAuth: []
tags:
- name: Proxy Filings
paths:
  /v1/proxy-filings:
    get:
      operationId: get_proxy_filings
      summary: Returns Schedule 14A proxy filings — the document public companies send…
      description: 'Returns Schedule 14A proxy filings — the document public companies send shareholders ahead of annual or special meetings. Each record is one filing carrying executive compensation tables, board nominations, shareholder proposals, auditor info, and voting matters. Use this when the user asks about: executive compensation, board elections, shareholder proposals, M&A votes, proxy contests, auditor changes, say-on-pay outcomes, or upcoming annual meetings. Coverage: the full DEF 14A family back to 2016 for the US public-company universe (sourced from EDGAR''s complete quarterly full-index); a daily feed keeps it current. Rows are tagged with a company''s PRIMARY common ticker — for dual-class issuers (e.g. GOOGL/GOOG, BRK-A/BRK-B) query by company_cik to retrieve every share class in one shot. Filing types (the four-form DEF 14A family): DEF 14A — Definitive proxy (the annual-meeting filing) DEFA14A — Additional materials (supplements to a prior DEF 14A) DEFM14A — Merger-related proxy (filed when shareholders vote on M&A) DEFR14A — Revised definitive proxy (amendments to a prior DEF 14A) Convenience flags derived from filing_type: is_merger_related — true for DEFM14A is_amendment — true for DEFR14A is_additional_materials — true for DEFA14A period_of_report population (IMPORTANT for filtering / sorting): - Recent-window rows (filed ~2024-onward via the daily feed / per-ticker pull): DEF 14A primaries ~100% populated (meeting/record date); DEFA14A/DEFM14A/DEFR14A typically EMPTY (correct-as-filed — SEC''s submissions API leaves those reportDate fields blank). - Historical backfilled rows (the bulk of 2016-2024 depth, sourced from EDGAR''s full-index): period_of_report is EMPTY for all form types — the index carries no report date. - Bottom line: filter/sort by filing_date for chronological queries; period_of_report is not reliably present across the collection. v1A is metadata-only: ticker, company name, CIK, filing type, dates, primary document URL. The proxy body is not extracted in v1. `primary_document_url` points agents at the source HTML for direct fetch when they need exec comp tables or proposal text.'
      parameters:
      - name: ticker
        in: query
        required: false
        description: Stock symbol filter, e.g. 'AAPL'. Case-insensitive.
        schema:
          type: string
      - name: company_cik
        in: query
        required: false
        description: SEC CIK number (10-digit, padded). Alternative to ticker.
        schema:
          type: string
      - name: filing_type
        in: query
        required: false
        description: Exact filing-type filter. Use 'DEFM14A' for M&A-vote proxies only, 'DEF 14A' for annual proxies only.
        schema:
          type: string
          enum:
          - DEF 14A
          - DEFA14A
          - DEFM14A
          - DEFR14A
      - name: is_merger_related
        in: query
        required: false
        description: 'Convenience flag: filter to DEFM14A only.'
        schema:
          type: boolean
      - name: is_amendment
        in: query
        required: false
        description: 'Convenience flag: filter to DEFR14A (revised) only.'
        schema:
          type: boolean
      - name: since
        in: query
        required: false
        description: ISO date (YYYY-MM-DD). Only records on or after this date.
        schema:
          type: string
      - name: until
        in: query
        required: false
        description: ISO date (YYYY-MM-DD). Only records on or before this date.
        schema:
          type: string
      - name: sort_by
        in: query
        required: false
        description: Default filing_date.
        schema:
          type: string
          enum:
          - filing_date
          - period_of_report
      - name: sort_order
        in: query
        required: false
        description: Default desc.
        schema:
          type: string
          enum:
          - desc
          - asc
      - name: limit
        in: query
        required: false
        description: Default 50, max 500.
        schema:
          type: integer
      responses:
        '200':
          description: 'JSON envelope: { results: [...], count, has_more }.'
        '400':
          description: Invalid parameter.
        '401':
          description: Missing or invalid API key.
        '402':
          description: This tool requires a higher plan (upgrade_required). Retrying will not help.
        '429':
          description: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.
      tags:
      - Proxy Filings
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key