# Search entities

People and organizations across every source: donors, employers, lobbyists, lobbying clients and firms, members. One entity per real-world person or organization, matched across sources by id where the State flags a donor as a lobbyist or client, otherwise by name (matchConfidence 0.8: people with the same name may be merged). Sorted by money given to members.

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

## 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 |  | Part of the name. |
| `kind` | string |  | One of: `person`, `organization`. |
| `role` | string |  | One of: `member`, `donor`, `employer`, `lobbyist`, `lobby_client`, `lobby_firm`. |
| `limit` | integer |  | Default `50`. |
| `cursor` | string |  | From meta.nextCursor of the previous page. |

## Response

200 Entities

## Example request

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