---
title: "Get one politician's profile and trades"
method: GET
path: "/v1/politician/{politicianId}"
tags: ["Politicians"]
---

# Get one politician's profile and trades

`GET /v1/politician/{politicianId}`

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

Returns a single politician filer's aggregated profile plus their individual disclosed transactions, newest transaction date first unless sort says otherwise. asset and transactionType narrow the trades; pageNumber and pageSize page through the trades that match, and pagination.totalCount counts them. profile and activityByQuarter always cover all of the filer's trades.

## Path parameters

- `politicianId` string, required: The filer's id: the Congress bioguide id for a member, an oge- id for an executive-branch official.

## Query parameters

- `pageNumber` integer: Page number (1-indexed).
- `pageSize` integer: Rows per page, at most 1000.
- `asset` string: Narrows trades to one asset, case-insensitive: a trade matches when its asset.filedTicker, asset.listing.ticker or the company's US common ticker equals this text, or its asset.name contains it. At most 64 characters.
- `transactionType` string: Narrows trades to these transactionType values, comma-separated: purchase, sale, sale_full, sale_partial, exchange. Every row of an exchange matches exchange.
- `sort` string: Orders the trades, newest first, by transactionDate or disclosureDate (disclosureDate, ties by transaction date). Defaults to transactionDate.
- `apiKey` string: API Key (alternatively send via X-Api-Key header)

## Response `200`

Politician profile and paginated 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 or the company details are updated: a client reading several pages restarts when it moves.
  - `profile` object, required: The filer's profile over all of their trades, whatever the filters. topAssets holds up to ten 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.
  - `activityByQuarter` object[], required: Trade counts per calendar quarter of transactionDate over all of the filer's trades, whatever the page, asset and transactionType, oldest quarter first. Quarters with no trades are omitted.
    - `calendarYear` integer, required: The calendar year.
    - `calendarQuarter` integer, required: The calendar quarter, 1 to 4.
    - `purchaseCount` integer, required: Purchases.
    - `saleCount` integer, required: sale, sale_full and sale_partial trades.
    - `exchangeCount` integer, required: Exchanges, each counted once.
  - `pagination` object, required: Over the trade rows that match asset and transactionType (every row when neither is set). When the filing reports an exchange as two rows (disposed and acquired), that exchange counts as two rows here but once in profile.tradeCount.
    - `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 unless sort says otherwise.
    - `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.
      - `company` object, nullable, required: The listed company the asset belongs to, such as the issuer of a stock, bond or option. Null when the asset is not linked to a listed company.
        - `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.
      - `successorCompany` object, nullable, required: For an issuer with no company of its own that was later acquired by or merged into a listed company: that company, where the business went. Never the traded issuer itself. Null otherwise.
        - `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.
    - `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/politician/:politicianId/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)
