# Timeline of events

Events in date order: contributions, lobbying, gifts, legislation introduced, divided votes, roll calls. Filter by at least one of member, matter, entity, kind, or a date range. Newest first.

`GET https://www.chicagopolitics.org/api/v1/timeline`

## Authorizations

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

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `member` | integer |  | Member id. |
| `matter` | string |  | Matter id. |
| `entity` | string |  | Entity id (as actor or target). |
| `kind` | string |  | Comma-separated: contribution, lobbyist_contribution, gift, lobbying, lobbied_on, introduced, vote_yes, vote_no, roll_call. |
| `from` | string (date) |  |  |
| `to` | string (date) |  |  |
| `limit` | integer |  | Default `50`. |
| `cursor` | string |  | From meta.nextCursor of the previous page. |

## Response

200 Events

## Example request

```bash
curl "https://www.chicagopolitics.org/api/v1/timeline" \
  -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/get-timeline · Chicago Politics, an independent, nonpartisan tracker of the Chicago City Council. Guide for agents: https://www.chicagopolitics.org/llms.txt