---
title: "List politician trade filers"
method: GET
path: "/v1/politicians"
tags: ["Politicians"]
---

# List politician trade filers

`GET /v1/politicians`

## Request

- Base URL: `https://api.fiscal.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fiscal.ai/v1/politicians`
- Auth: API key in query parameter `apiKey`

Returns the directory of politician filers (members of the U.S. House and Senate, and executive-branch officials who file with OGE) with per-filer trade activity aggregated from their disclosed transaction reports. Sorted by trade count descending. Plans with politician trades include every politician. A key whose plan does not include them gets the free sample: this endpoint lists the politicians it includes, and only their profiles are served.

## Query parameters

- `pageNumber` integer: Page number (1-indexed).
- `pageSize` integer: Rows per page, at most 1000.
- `apiKey` string: API Key (alternatively send via X-Api-Key header)

## Response `200`

Politician filer directory

- object
  - `meta` object, required: About the data in this response.
    - `publicationVersion` string, required: The version of the data this page belongs to, compared only for equality. It changes whenever the trades or the company details are updated: a client reading several pages restarts when it moves.
  - `pagination` object, required: Over the filers in the directory.
    - `page` integer, required: The page returned, 1-indexed.
    - `pageSize` integer, required: Rows per page, as requested or the default.
    - `totalCount` integer, required: Rows across all pages.
    - `totalPages` integer, required: Pages at this pageSize; 1 when there are no rows. A later page returns an empty data list.
    - `hasNextPage` boolean, required: Whether a later page has rows.
    - `hasPreviousPage` boolean, required: Whether this page is after the first.
  - `data` object[], required: One profile per filer, most trades first. topAssets holds up to three entries here.
    - `politicianId` string, required: The filer's id: the Congress bioguide id for a member, an oge- id for an executive-branch official.
    - `politicianName` string, required: The filer's name: the official roster name for a member of Congress, the name on their OGE reports for an executive-branch official.
    - `source` 'house' | 'senate' | 'executive', required: house or senate for a member of Congress, from the chamber's periodic transaction reports; executive for an executive-branch official, from OGE 278-T and annual 278e reports. For a member, the chamber of their latest term.
    - `stateCode` string, nullable, required: The two-letter state of the member's latest term. Null for an executive-branch official.
    - `districtCode` string, nullable, required: State and two-digit House district of the latest term; AK00 is at large. Null for senators and executive-branch officials.
    - `isActive` boolean, required: Whether the filer still holds the office.
    - `party` string, nullable, required: The member's party at the end of their latest term, in lowercase: democrat, republican, independent or libertarian. Null for an executive-branch official.
    - `tradeCount` integer, required: Disclosed trades. An exchange reported as two rows (disposed and acquired) counts once.
    - `filingCount` integer, required: Reports that disclose at least one of the trades.
    - `distinctTickerCount` integer, required: Distinct tickers as filed. Trades filed without a ticker do not count.
    - `firstTransactionDate` string, date, required: The earliest transactionDate of the filer's trades.
    - `lastTransactionDate` string, date, required: The latest transactionDate of the filer's trades.
    - `lastDisclosureDate` string, date, nullable, required: The newest disclosureDate of the filer's trades: when they last disclosed a trade, however old the trade. Null when not known.
    - `disclosedVolumeMaxUsd` number, required: Sum in US dollars of every trade's band ceiling, with an open-ended band at its floor and an exact amount at itself: an upper bound, not a total.
    - `lateTradeCount` integer, required: Trades reported after their deadline (daysLate above 0). An exchange counts once.
    - `severelyLateTradeCount` integer, required: Trades reported more than 30 days after their deadline, when the $200 late filing fee applies. An exchange counts once.
    - `noticeLateCount` integer, required: Trades late on the 30-days-from-notice deadline by the filer's own answer (lateOnNotice), by an unknown number of days; not in lateTradeCount.
    - `unknownLatenessCount` integer, required: Trades with daysLate null, counted neither on time nor late: an executive's yearly-report trade with no deadline that applies (see yearlyReport), or a trade with an unreadable date.
    - `exemptTradeCount` integer, required: Of unknownLatenessCount, the yearly-report trades that needed no 278-T: an excepted investment fund, or a trade from before the filer took office.
    - `topAssets` object[], required: The companies and funds the filer traded most, most trades first, ties by latest trade. Up to three in the directory list, ten on a profile. Each names a company or a fund. Trades linked to neither do not count.
      - `company` object, nullable, required: The company the trades link to, counting trades in any of its securities: other share classes, ADRs, bonds and options. Null for a fund.
        - `companyFiscalIdentifier` string, nullable, required: The company's permanent id (FSCLC...); unlike companyKey, it never changes. Null when not known.
        - `companyKey` string, required: The company's current key (EXCHANGE_TICKER of its primary listing), which the /v1/company endpoints take. It changes when the company renames or moves its primary listing.
        - `displayNameEnglish` string, nullable, required: The company's name. Null when the company's details are not available.
        - `sector` string, nullable, required: The GICS sector. Null when not known.
        - `headquartersCountryCode` string, nullable, required: The headquarters country, as an ISO 3166-1 alpha-2 code. Null when not known.
        - `marketCapUsd` number, nullable, required: Current market capitalization in US dollars, not the value on the trade date. Null when not known.
        - `primaryListing` object, nullable, required: The company's main listing. For a company with several share classes it names one class, which may not be the one traded. Null when the company's details are not available.
          - `ticker` string, nullable, required: The listing's ticker. Null when not known.
          - `exchangeCode` string, nullable, required: The listing's exchange code. Null when not known.
          - `exchangeName` string, nullable, required: The exchange's name. Null when not known.
          - `operatingMic` string, nullable, required: The exchange's ISO 10383 operating MIC. Null when not known.
      - `fund` object, nullable, required: The fund (ETF, mutual fund, money market fund) the trades link to. Null for a company.
        - `fundFiscalIdentifier` string, required: The fund's permanent id (FSCLF...).
        - `securityFiscalIdentifier` string, nullable, required: The permanent id (FSCLK...) of the share class the filer traded. Null when they traded more than one of the fund's classes, or no trade names a class.
        - `ticker` string, nullable, required: That share class's ticker. Null when the class has none or no single class is named.
      - `tradeCount` integer, required: The filer's trades linked to this company or fund. An exchange reported as two rows counts once, on its disposed row.
      - `filedTickers` string[], required: The distinct tickers the filings printed on these trades, most used first. Empty when they printed none.
    - `relatedProfiles` object[], required: Other profiles of the same person, such as a member of Congress who later filed as an executive-branch official. Empty for almost every filer.
      - `politicianId` string, required: The filer's id: the Congress bioguide id for a member, an oge- id for an executive-branch official.
      - `politicianName` string, required: The other profile's name.
      - `source` 'house' | 'senate' | 'executive', required: The other profile's source.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `503`: Politician trades or the companies directory are temporarily unavailable

## Changes

- **2026-11-12** `90bd70a65af2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fiscal/apis/fiscal-api/changes/v1/politicians/get.md)

---

[API](https://skmtc.dev/fiscal/apis/fiscal-api.md) - [All operations](https://skmtc.dev/fiscal/apis/fiscal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fiscal/apis/fiscal-api/revisions/c0cf7401f8e5?raw)
