KeyVex Lobbying Filings API

The Lobbying Filings API from KeyVex — 1 operation(s) for lobbying filings.

GitHub OpenAPI

Operations 1

GET /v1/lobbying-filings Returns Lobbying Disclosure Act (LDA) filings — quarterly LD-2 reports filed by… #

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-lobbying-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-lobbying-filings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KeyVex Lobbying 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: Lobbying Filings
paths:
  /v1/lobbying-filings:
    get:
      operationId: get_lobbying_filings
      summary: Returns Lobbying Disclosure Act (LDA) filings — quarterly LD-2 reports filed by…
      description: 'Returns Lobbying Disclosure Act (LDA) filings — quarterly LD-2 reports filed by registered lobbyist firms with the Senate Office of Public Records. Each record covers one (registrant, client, quarter) tuple, listing income paid, issues lobbied on, and government entities contacted. Use this when the user asks about: who''s paying lobbyists, what issues a company is lobbying on, which senators or agencies a firm is contacting, lobbying spend by industry or sector, or to cross lobbying activity against congressional trades or federal contracts for political-influence analysis. Each filing has a `lobbying_activities` array (one entry per issue area worked on) plus three flattened summary arrays at top level: - general_issue_codes: 3-char codes (DEF, HEA, TRA, ENV, FIN, ...) - government_entities: agencies/branches contacted - lobbyist_names: lobbyists who worked the issue Top-level arrays support indexed queries; the nested array carries issue-level descriptions and lobbyist position info. `general_issue_codes` filter is OR-semantic — pass an array, match any filing containing AT LEAST ONE of those codes (max 30, per Firestore array-contains-any). Examples: [''DEF''] for defense, [''HEA'',''MMM''] for health + Medicare/Medicaid, [''TAX'',''FIN''] for tax + financial services. Income vs expenses (IMPORTANT for ranking by spend): the LDA mandates a hard split. Third-party lobbying firms report `income` (what the client paid them); in-house corporate lobbying departments report `expenses` (what they spent). The two fields are mutually exclusive — any given filing has one or the other, not both. In practice ~30% of filings have income, ~70% have expenses, with a small population reporting neither (administrative registrations). So `sort_by=income` ranks the third-party-firm subset; for an actual top-spenders leaderboard, agents should fetch both populations and sum `income + expenses` per filing client-side. v1.1 polish will add a derived `total_lobbying_spend` field that does this sum server-side for indexed queries. client_is_government is true when the client is a government body (US states often hire lobbyists). Activity descriptions are truncated at 5000 chars during ingestion to stay under Firestore''s per-doc cap; agents can fetch the full filing via filing_document_url for the unbounded prose.'
      parameters:
      - name: registrant_name
        in: query
        required: false
        description: Substring match against the lobbying firm's name (case-insensitive). E.g., 'Akin Gump', 'Brownstein'.
        schema:
          type: string
      - name: client_name
        in: query
        required: false
        description: Substring match against the paying client's name (case-insensitive). E.g., 'Pfizer', 'Lockheed Martin', 'STATE OF CALIFORNIA'.
        schema:
          type: string
      - name: filing_year
        in: query
        required: false
        description: Calendar year of the reporting period (NOT the filing date).
        schema:
          type: integer
      - name: filing_period
        in: query
        required: false
        description: Reporting period within filing_year. Quarters for LD-2; mid_year/year_end for LD-203 contributions windows.
        schema:
          type: string
          enum:
          - first_quarter
          - second_quarter
          - third_quarter
          - fourth_quarter
          - mid_year
          - year_end
      - name: general_issue_codes
        in: query
        required: false
        description: Array of 3-char issue codes (OR semantics). E.g., ['DEF'] for defense, ['HEA','MMM'] for health+Medicare. Max 30 codes per query. (comma-separated)
        schema:
          type: string
      - name: government_entity
        in: query
        required: false
        description: Substring match against any government entity contacted. E.g., 'SENATE', 'Treasury', 'FDA', 'Defense, Dept of'.
        schema:
          type: string
      - name: min_income
        in: query
        required: false
        description: Filter to filings with income >= this amount (USD). Use to focus on big-dollar lobbying spend.
        schema:
          type: number
      - name: since
        in: query
        required: false
        description: ISO date (YYYY-MM-DD). Only records on or after this date, using sort_by as the date field.
        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: 'Field used for ordering and for since/until filters. Default: dt_posted (when the filing was submitted).'
        schema:
          type: string
          enum:
          - dt_posted
          - filing_year
          - income
      - name: sort_order
        in: query
        required: false
        description: 'Default: desc (most recent / largest first).'
        schema:
          type: string
          enum:
          - desc
          - asc
      - name: limit
        in: query
        required: false
        description: Maximum records to return. 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:
      - Lobbying Filings
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key