# Track legislation by stage

Every matter this term by lifecycle stage, updated hourly. Stages: submitted, introduced, committee, council, passed, failed (or vetoed), filed (placed on file or withdrawn), substituted (folded into a substitute). meta.facets has counts by stage and type for the current filters; meta.updated says when the hourly job last ran (7 am-noon and 4-8 pm Chicago time). Each matter includes latestAction (date, action, by, text, votes) and vote (its most recent roll call).

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

## 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 |
| --- | --- | --- | --- |
| `q` | string |  |  |
| `type` | string |  | Comma-separated: Ordinance, Resolution, Order, Appointment, Executive Order, Claim, Report, Communication |
| `stage` | string |  | Comma-separated stages |
| `topic` | string |  | One of: `zoning`, `agreements`, `money`, `code`, `streets`, `honors`, `appointments`, `executive`, `claims`, `property`. |
| `ward` | integer |  | Lead sponsor (member id) |
| `routine` | string |  | services hides parking permits, honors, claims, and sign permits; exclude/only use the Clerk routine flag (which also covers zoning and property sales) One of: `include`, `services`, `exclude`, `only`. Default `include`. |
| `from` | string (date) |  |  |
| `to` | string (date) |  |  |
| `changed_since` | string (date) |  |  |
| `sort` | string |  | One of: `activity`, `introduced`, `final`. Default `activity`. |
| `limit` | integer |  | Default `50`. |
| `cursor` | string |  | From meta.nextCursor of the previous page. |

## Response

200 Matters

## Example request

```bash
curl "https://www.chicagopolitics.org/api/v1/tracker" \
  -H "Authorization: Bearer $CHICAGO_POLITICS_KEY"
```

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

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