# Topics

> The business topics records are tagged with, to follow one subject across every drawer.

Agenda items, motions, meeting documents and recordings are tagged with business topics, such as `short_term_rentals`, `data_centres`, `solar_and_storage`, `telecom_siting`, `zoning` and `procurement`. Read the tags here, or pass a topic as `topic` on meetings, agenda items and motions to follow it across governments.

A record with no tag is not yet tagged. It does not mean the topic is absent.

## Topic tags

### `GET /v1/topics`

**List business topic tags.** The business topics given to agenda items, motions, documents and recordings (data centres, short-term rentals, solar and storage, telecom siting, zoning, procurement, …). A record with no tag is not yet tagged. Billed as one records request a page. Filters: jurisdiction, topic, kind, from, to, since, meeting.

[Reference and playground for list business topic tags](https://data.heytownhall.com/docs/reference/topics/get-v1-topics)

| Parameter      | What it takes                                                            |
| -------------- | ------------------------------------------------------------------------ |
| `jurisdiction` | A jurisdiction id.                                                       |
| `topic`        | A business topic id (GET /v1/topics lists the tags given).               |
| `kind`         | The subject kind: meeting_item, motion, meeting_document, recording.     |
| `from`         | On or after this date (YYYY-MM-DD).                                      |
| `to`           | On or before this date (YYYY-MM-DD).                                     |
| `since`        | Records read at or after this instant: what is new since your last read. |
| `meeting`      | A meeting id.                                                            |

Pages with `limit` and `cursor` ([pagination](https://data.heytownhall.com/docs/pagination)).

| Field              | Type           | What it holds                                                   |
| ------------------ | -------------- | --------------------------------------------------------------- |
| `id`               | string         |                                                                 |
| `subject_kind`     | string         | meeting_item, motion, meeting_document, recording.              |
| `subject_id`       | string         |                                                                 |
| `meeting_id`       | string or null |                                                                 |
| `jurisdiction_id`  | string         |                                                                 |
| `topic`            | string         |                                                                 |
| `taxonomy_version` | string         |                                                                 |
| `confidence`       | number         |                                                                 |
| `source_url`       | string or null | The page, document, video or platform the record was read from. |
| `read_at`          | string or null | When it was read.                                               |