Annual Disclosures List

GET https://api.unusualwhales.com/api/politician-portfolios/disclosures

Request

Security: Bearer Auth Authorization: Bearer <token>

Query Parameters

politician_id string optional

Filter by politician ID

latest_only boolean optional

If true, returns only the most recent disclosure per politician

year integer optional

Filter by disclosure year

Responses

200 422 500

Response Body 200 OK

chamber string

The chamber (house, senate, executive).

disclosure_year integer

The year covered by the disclosure.

filing_date string

The date the disclosure was filed.

id string

The file record ID.

name string

The filer name as it appears on the disclosure.

politician_id string

The politician's ID.

politician_name string

The politician's name.

url string

The URL to the disclosure PDF.

version integer

The version number of the disclosure.

Try It GET

API Token

Query Parameters

politician_id string

latest_only boolean

year integer

Request Sample

curl -X GET "https://api.unusualwhales.com/api/politician-portfolios/disclosures" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/politician-portfolios/disclosures", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "chamber": "house",
      "disclosure_year": 2024,
      "filing_date": "2024-05-15",
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Warren Davidson",
      "politician_id": "e138f347-ae92-4cfb-8f41-7036ff09a213",
      "politician_name": "Warren Davidson",
      "url": "https://disclosures-clerk.house.gov/public_disc/financial-pdfs/2024/10067467.pdf",
      "version": 1
    }
  ]
}