Browse the docs

Congress returns

GET/v1/congress/returns

An estimate of how a member of Congress's stock purchases in one year have done since: each purchase priced on its trade date at the midpoint of its disclosed amount range, then marked to today's price, across their ten most-traded stocks. An estimate from disclosed ranges, not their actual account.

Each call counts against your allowance.

Parameters

NameInTypeWhat it does
name (required)querytextPart of a member of Congress's name.
yearquerywhole number, 2012–2100The year of the purchases. Leave it out for this year.

Any other parameter is refused, so a typo is caught rather than quietly ignored.

Answer

The answer is { data, asOf }. Here is data, abridged: real answers carry more fields.

data (abridged)
{
  "politician": "Jane Example",
  "chamber": "House",
  "party": "D",
  "year": 2026,
  "percentageGain": 12.4,
  "totalGainLoss": 18600,
  "totalInvestedAmount": 150000,
  "tradesAnalyzed": 9,
  "totalTrades": 11,
  "symbolsAnalyzed": 6,
  "note": "Based on 9 of 11 purchase trades. Estimated using midpoint of reported ranges."
}

Answers and errors covers every answer’s shape and what an error carries.