# Zoning

> Documentation index: [llms.txt](https://westkite.com/docs/llms.txt). Every page is also at its URL plus `.md`.

Returns the zoning district at a property or a point: the local zone code and name, a broad class and the published map it comes from. Free.

```endpoint
GET /v1/zoning
```

## Parameters

| Name | Type | Description |
|---|---|---|
| `property_id` | string | A property ID. Or send `lat` and `lng`. |
| `lat`, `lng` | number | A point in the United States, in decimal degrees, instead of `property_id`. |

## Request

```curl
curl --get "https://api.westkite.com/v1/zoning" \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  --data-urlencode "lat=41.8819" \
  --data-urlencode "lng=-87.6278"
```

```typescript
const params = new URLSearchParams({ lat: "41.8819", lng: "-87.6278" });
const res = await fetch(`https://api.westkite.com/v1/zoning?${params}`, {
  headers: { Authorization: `Bearer ${process.env.WESTKITE_API_KEY}` },
});
const { data, missing } = await res.json();
```

```python
import os, requests

res = requests.get(
    "https://api.westkite.com/v1/zoning",
    params={"lat": 41.8819, "lng": -87.6278},
    headers={"Authorization": f"Bearer {os.environ['WESTKITE_API_KEY']}"},
)
body = res.json()
```

## Response

```json 200
{
  "data": {
    "coordinates": { "lat": 41.8819, "lng": -87.6278 },
    "district": {
      "code": "DX-16",
      "name": null,
      "class": "mixed",
      "class_label": "Mixed use",
      "jurisdiction": "Chicago",
      "source": {
        "id": "ZON-IL-002",
        "publisher": "City of Chicago",
        "name": "Boundaries - Zoning Districts (current)",
        "url": "https://data.cityofchicago.org/d/dj47-wfun",
        "vintage": "2026-11-04 (rowsUpdatedAt)"
      }
    },
    "note": "The district is read from the city or county's published zoning map at this point…"
  },
  "missing": [],
  "billing": { "operation_id": "op_5c1d…", "operation": "zoning", "charged_usd": 0, "balance_usd": 9.85 },
  "request_id": "req_5c1d…"
}
```

| Field | Meaning |
|---|---|
| `district.code` | The zone code as the city or county publishes it, such as `M1-2` or `I-1` |
| `district.name` | The district's local name or description, when the map gives one |
| `district.class` | A broad class read from the local name and code: `residential`, `multifamily`, `commercial`, `office`, `mixed`, `industrial`, `agricultural`, `open`, `public`, `planned` or `other` |
| `district.jurisdiction` | The city, town, township or county whose zoning this is |
| `district.source` | The published zoning map the district comes from, with its publisher, link and vintage |
| `other_districts` | Only where a jurisdiction's own map overlaps itself at the point |

- **Coverage.** The zoning map holds over 5,000 cities and counties. In a city, the city's own map is used. In unincorporated land, the county's map is used.
- **Not covered yet.** Where no map covers the place, `district` is `null` and `missing` says `not_covered`. A property's zoning code from the assessor roll is still in the [property record's](https://westkite.com/docs/api/properties.md#zoning) `zoning` part. [Ask for a jurisdiction](https://westkite.com/docs/api/data-requests.md) you need.
- **No district.** Where the map covers the place but draws no district at the point, such as a street, rail line or water, `missing` says `not_published`.
- **A reading, not a determination.** The class is read from the local name and code. Overlays, conditions and recent rezonings are not included. Check with the jurisdiction before relying on it.

The same district is in a property record as `zoning.map_district` when you ask for `parts=zoning`.

## Errors

| Code | When |
|---|---|
| [`invalid_request`](https://westkite.com/docs/api/errors.md#invalid_request) | Both or neither of `property_id` and `lat`/`lng`, or a point outside the United States. |
| [`not_found`](https://westkite.com/docs/api/errors.md#not_found) | No published property with a location has that ID. |
