---
title: "Get politician trades in a company"
method: GET
path: "/v1/company/politician-trades"
tags: ["Politicians"]
---

# Get politician trades in a company

`GET /v1/company/politician-trades`

## 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/company/politician-trades`
- Auth: API key in query parameter `apiKey`

Returns every disclosed politician transaction in the company's securities (members of the U.S. House and Senate, and executive-branch officials filing with OGE), across all filers, sorted by transaction date descending. Each trade names its filer in filer.politicianId, which GET /v1/politician/{politicianId} resolves to that politician's profile and trades. The company is named once, at the top. Paginated via pageNumber and pageSize. Plans with politician trades include every company; a key whose plan does not include them gets the free-sample companies.

## Query parameters

- `apiKey` string: API Key (alternatively send via X-Api-Key header)
- `ticker` string: Company ticker, use with mic or alone for US tickers
- `micCode` string: Company MIC, use with ticker
- `exchange` string: Company exchange code, use with ticker
- `companyKey` string: Company key (alternative to ticker/micCode/exchange)
- `cusip` string: Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP
- `isin` string: Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN
- `figi` string: FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.
- `cik` string: Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.
- `fscl` string: Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.
- `pageNumber` integer: Page number (1-indexed).
- `pageSize` integer: Rows per page, at most 1000.

## Response `200`

The company's politician trades

- 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 are updated: a client reading several pages restarts when it moves.
  - `companyKey` string, required: The company the request resolved to, by its current key.
  - `companyFiscalIdentifier` string, nullable, required: The company's permanent id (FSCLC...). Null when the company has none.
  - `pagination` object, required: Over the company's trade rows. An exchange the filing reports as two rows (disposed and acquired) counts as two.
    - `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: The page of trades, newest transactionDate first, in every security of the company: common stock, other share classes, ADRs, preferreds, bonds and options.
    - `filer` object, required: Who filed the trade.
      - `politicianId` string, required: The filer's id: the Congress bioguide id for a member, an oge- id for an executive-branch official. GET /v1/politician/{politicianId} returns their profile and trades.
      - `politicianName` string, required: The filer's name.
    - `tradeId` string, required: The trade row's id. It stays the same while the filing reports the trade the same way; if the trade's details change, it gets a new id, and an id is never reused.
    - `transactionDate` string, date, required: The date of the trade, as the filing states it.
    - `transactionType` 'purchase' | 'sale' | 'sale_full' | 'sale_partial' | 'exchange', required: sale_full and sale_partial come from forms that let the filer mark a sale partial; sale comes from forms that do not, so whether the whole position was sold is unknown.
    - `owner` 'self' | 'spouse' | 'joint' | 'dependent_child', required: Who made the trade: the filer, their spouse, the two jointly, or a dependent child.
    - `notificationDate` string, date, nullable, required: When the filer says they learned of the trade, which can be after the trade for a spouse's or managed account. Null on forms without the column, such as every Senate and executive report.
    - `disclosureDate` string, date, required: When the trade was first disclosed: filing.filingDate, the date the ethics office received an executive's yearly report, or for a trade an amendment restates, the original filing's date. daysLate counts from it.
    - `daysLate` integer, nullable, required: Calendar days past the STOCK Act deadline at disclosureDate, after any filing extension the form prints; null when a date is unreadable, or for a yearly-report trade that needed no 278-T or was not shown to (see yearlyReport).
    - `lateOnNotice` boolean, nullable, required: OGE 278-T: true when the filer says notice came over 30 days before filing, missing the 30-days-from-notice deadline though inside 45 days. False on House and Senate rows (see daysLate). Null on yearly-report trades or an unknown filing extension.
    - `yearlyReport` 'due_on_278t' | 'excepted_fund' | 'before_office' | 'not_classified' | 'null', nullable, required: For a trade only an executive's yearly report lists, else null: due_on_278t, a listed security traded in office, due on a 278-T; excepted_fund, an excepted investment fund; before_office, traded before taking office; not_classified, undetermined.
    - `filerComment` string, nullable, required: The filer's note on the trade, as printed. Null on a dependent child's trade.
    - `subholding` string, nullable, required: The account or subholding the filing names. Null on a dependent child's trade.
    - `asset` object, required: What was traded, and what it links to.
      - `name` string, required: The asset as the filing named it.
      - `filedTicker` string, nullable, required: The ticker as the filing printed it, which can name a share class, ADR or OTC line, or hold the filer's typo. Null when the filing printed none.
      - `assetType` 'stock' | 'option' | 'corporate_bond' | 'government_bond' | 'municipal_bond' | 'fund' | 'cryptocurrency' | 'other' | 'null', nullable, required: The asset's kind: stock (shares, ADRs, preferreds), option, corporate_bond, government_bond (Treasury, agency, House state or local), municipal_bond (Senate only), fund (ETF, mutual, money market, private), cryptocurrency, or other (futures, annuities, businesses). Null with no code, listing or fund.
      - `linkStatus` 'linked' | 'not_in_entity_list' | 'no_entity_type' | 'unresolved' | 'null', nullable, required: How the asset matched: linked to a company or fund; not_in_entity_list, a listed issuer outside the companies list (often acquired or delisted); no_entity_type, an asset with no listed issuer (a municipal bond, a private fund); unresolved, not matched.
      - `listing` object, nullable, required: The US listing the trade points to: the share class or ADR the filed ticker names, else the main US listing of the security traded. Null when none applies, such as an unnamed share class or a delisted company.
        - `listingFiscalIdentifier` string, nullable, required: The listing's permanent id (FSCLL...). Null when not known.
        - `ticker` string, required: The listing's ticker.
        - `exchangeCode` string, required: The listing's exchange code.
      - `fund` object, nullable, required: The fund (ETF, mutual fund, money market fund) whose shares were traded. Null when the asset is not a fund.
        - `fundFiscalIdentifier` string, required: The fund's permanent id (FSCLF...).
        - `securityFiscalIdentifier` string, nullable, required: The permanent id (FSCLK...) of the share class the filing names. Null when the fund has several classes and the filing names none.
        - `ticker` string, nullable, required: The share class's ticker. Null when the class has none.
    - `amount` object, required: The amount as disclosed: a band, or an exact amount.
      - `lowUsd` number, required: The disclosed band's floor in US dollars, or the exact amount.
      - `highUsd` number, nullable, required: The disclosed band's ceiling in US dollars; equal to lowUsd for an exact amount, null for an open-ended band ('Over $50,000,000', or spouse or dependent child 'over $1,000,000').
      - `bandLabel` string, nullable, required: The STOCK Act band as printed; null when the amount is exact.
    - `filing` object, required: The report this row was read from.
      - `filingId` string, required: The regulator's id for the report: the House Clerk's numeric document id, the Senate eFD report's UUID, or oge- and OGE's document id for an executive-branch report.
      - `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.
      - `filingDate` string, date, required: When the report was filed: the House Clerk or Senate eFD filing date, an OGE 278-T's signing date (its posting date when the file name has none), or the date OGE posted an executive's yearly report.
      - `originalSourceUrl` string, nullable, required: The report on the regulator's site. Null when no link is known.

## 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/company/politician-trades/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)
