# List a committee's filed documents

Every document a campaign committee filed with the State Board of Elections, with a link to each. Newest first: D-1 Statement of Organization, D-2 quarterly, semiannual, pre-election and final reports (with their totals), A-1 and B-1 ($1,000+) reports, raffle reports, letters. document.url opens the filing on elections.il.gov: a report page for electronic filings (format html), the scanned PDF for paper ones (format pdf; ISBE has no scan of some older paper filings, and then document is null). superseded is ISBE's archived flag: replaced by an amendment, or an A-1/B-1 whose contributions were reported again on the next D-2.

`GET https://www.chicagopolitics.org/api/v1/campaign-committees/{id}/filings`

## Authorizations

| Header | Value |
| --- | --- |
| `Authorization` | `Bearer <key>`. [Get a key](https://www.chicagopolitics.org/account); see [authentication](https://www.chicagopolitics.org/developers/authentication). |

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | ISBE committee id |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `form` | string |  | One of: `A-1`, `B-1`, `D-1`, `D-2`. |
| `from` | string (date) |  | Filed on or after. |
| `to` | string (date) |  | Filed on or before. |
| `superseded` | string |  | One of: `include`, `exclude`. Default `include`. |
| `limit` | integer |  | Default `50`. |
| `cursor` | string |  | From meta.nextCursor of the previous page. |

## Response

200 Filings: a list in `data`, with `meta` and `links` (see [pagination](https://www.chicagopolitics.org/developers/requests)).

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | ISBE filed document id |
| `form` | string \| null | As the committee page labels it, e.g. D-2 Quarterly Report, A-1 ($1000+ Year Round) |
| `type` | string \| null | ISBE document name: Quarterly, A-1, B-1, Statement of Organization, Final ... |
| `amended` | boolean |  |
| `superseded` | boolean |  |
| `periodBegin` | string \| null (date) |  |
| `periodEnd` | string \| null (date) |  |
| `election` | object \| null |  |
| `filed` | string \| null | When ISBE received it (Chicago time), YYYY-MM-DDTHH:MM:SS |
| `filedElectronically` | boolean |  |
| `pages` | integer \| null |  |
| `clarification` | string \| null |  |
| `totals` | object \| null |  |
| `document` | object \| null |  |

## Example request

```bash
curl "https://www.chicagopolitics.org/api/v1/campaign-committees/{id}/filings" \
  -H "Authorization: Bearer $CHICAGO_POLITICS_KEY"
```

Errors: `400`, `401`, `404`, `429` (see [errors](https://www.chicagopolitics.org/developers/errors)).

---
Source: https://www.chicagopolitics.org/developers/api/list-campaign-filings · Chicago Politics, an independent tracker of the Chicago City Council. Guide for agents: https://www.chicagopolitics.org/llms.txt