# Annual Disclosures List

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

Returns all annual disclosure file records for politicians.
Can be filtered by politician_id and/or limited to latest per politician.

This is an enterprise only endpoint. Contact dev@unusualwhales.com for details about accessing this data.



## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `politician_id` | string | No | Filter by politician ID |
| `latest_only` | boolean | No | If true, returns only the most recent disclosure per politician |
| `year` | integer | No | Filter by disclosure year |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `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. |


## Example

### curl

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

### Python

```python
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

```json
{
  "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
    }
  ]
}
```