# Development

> Development applications, permits with their rules and fees, and road and utility works.

What is being built, what it takes to build, and what is being dug up.

## Development applications

### `GET /v1/applications`

**List development applications.** Rezonings, development permits and subdivisions a government's tracker lists, with their stage. Billed as one records request a page. Filters: jurisdiction, region, country, kind, from, to, since.

[Reference and playground for list development applications](https://data.heytownhall.com/docs/reference/land-use/get-v1-applications)

| Parameter      | What it takes                                                            |
| -------------- | ------------------------------------------------------------------------ |
| `jurisdiction` | A jurisdiction id.                                                       |
| `region`       | A two-letter province or state code.                                     |
| `country`      | CA or US.                                                                |
| `kind`         | The application kind, such as rezoning.                                  |
| `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. |

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

| Field              | Type           | What it holds                                                   |
| ------------------ | -------------- | --------------------------------------------------------------- |
| `id`               | string         |                                                                 |
| `jurisdiction_id`  | string         |                                                                 |
| `country`          | string or null |                                                                 |
| `region`           | string or null |                                                                 |
| `title`            | string         |                                                                 |
| `address`          | string or null |                                                                 |
| `folder_number`    | string or null |                                                                 |
| `application_kind` | string or null |                                                                 |
| `type_label`       | string or null |                                                                 |
| `status`           | string or null |                                                                 |
| `applied_on`       | string or null | YYYY-MM-DD.                                                     |
| `stage`            | string or null |                                                                 |
| `stage_since`      | string or null | YYYY-MM-DD.                                                     |
| `listed_at`        | string or null | ISO 8601 instant, UTC.                                          |
| `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.                                               |

## Permits, rules and fees

### `GET /v1/permits`

**List permits, their rules and fees.** Each kind of permit a government issues: where to apply, the fee table as published, the timeline it states and its desk. Billed as one records request a page. Filters: jurisdiction, region, country, kind, since.

[Reference and playground for list permits, their rules and fees](https://data.heytownhall.com/docs/reference/land-use/get-v1-permits)

| Parameter      | What it takes                                                            |
| -------------- | ------------------------------------------------------------------------ |
| `jurisdiction` | A jurisdiction id.                                                       |
| `region`       | A two-letter province or state code.                                     |
| `country`      | CA or US.                                                                |
| `kind`         | The permit kind, such as building.                                       |
| `since`        | Records read at or after this instant: what is new since your last read. |

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

| Field              | Type           | What it holds                                                                                            |
| ------------------ | -------------- | -------------------------------------------------------------------------------------------------------- |
| `id`               | string         |                                                                                                          |
| `jurisdiction_id`  | string         |                                                                                                          |
| `country`          | string or null |                                                                                                          |
| `region`           | string or null |                                                                                                          |
| `kind`             | string         |                                                                                                          |
| `page_title`       | string or null |                                                                                                          |
| `portal_url`       | string or null |                                                                                                          |
| `portal_platform`  | string or null |                                                                                                          |
| `fee_heading`      | string or null |                                                                                                          |
| `fee_rows`         | any            | The fee table as read, rows of the page's own columns; null when the fee page changed since it was read. |
| `fee_quote`        | string or null |                                                                                                          |
| `fee_source_url`   | string or null |                                                                                                          |
| `fee_bylaw_number` | string or null |                                                                                                          |
| `timeline_quote`   | string or null |                                                                                                          |
| `desk_phone`       | string or null | The permit desk's published number (an office, not a person).                                            |
| `desk_email`       | string or null |                                                                                                          |
| `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.                                                                                        |

## Road and utility works

### `GET /v1/works`

**List road and utility works.** Announced road and utility work, with its days and streets. Billed as one records request a page. Filters: jurisdiction, region, country, kind, from, to, since.

[Reference and playground for list road and utility works](https://data.heytownhall.com/docs/reference/land-use/get-v1-works)

| Parameter      | What it takes                                                            |
| -------------- | ------------------------------------------------------------------------ |
| `jurisdiction` | A jurisdiction id.                                                       |
| `region`       | A two-letter province or state code.                                     |
| `country`      | CA or US.                                                                |
| `kind`         | road or utility.                                                         |
| `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. |

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

| Field             | Type                    | What it holds                                                   |
| ----------------- | ----------------------- | --------------------------------------------------------------- |
| `id`              | string                  |                                                                 |
| `jurisdiction_id` | string                  |                                                                 |
| `country`         | string or null          |                                                                 |
| `region`          | string or null          |                                                                 |
| `title`           | string or null          |                                                                 |
| `kind`            | string or null          |                                                                 |
| `days`            | array of string or null |                                                                 |
| `from_day`        | string or null          | YYYY-MM-DD.                                                     |
| `to_day`          | string or null          | YYYY-MM-DD.                                                     |
| `hours`           | string or null          |                                                                 |
| `streets`         | array of string         |                                                                 |
| `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.                                               |