# List or find wards

List wards, or find the ward for a location. With lat and lon, returns the one ward containing that point (or none).

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

## 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 |
| --- | --- | --- | --- |
| `lat` | number |  | Latitude (WGS84) |
| `lon` | number |  | Longitude (WGS84) |

## Response

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

| Field | Type | Description |
| --- | --- | --- |
| `ward` | integer |  |
| `member` | object |  |
| `boundary` | object | GeoJSON geometry (only with include=boundary) |
| `links` | object |  |

## Example request

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