Documentation menu

← Zoning

API reference

Search zoning

GET/v1/zoning

Finds the zoning at a place, or lists the zoning classifications in a jurisdiction.

For the zoning at a place, send one location: address, parcel, lat with lon, or bbox. A place has one base district and any number of overlays.

For every classification in an area, send jurisdiction or fips with no location. Add code for one district.

allowances and standards are included with include=allowance and include=standard. A use missing from allowances is not prohibited: unlisted_uses holds the ordinance's rule for it.

Parameters

query

addressstring | null
A street address, with city or postal code where known, such as 4516 Printer Ln, Raleigh NC 27613. Zoning is looked up at the center of the best-matching parcel.
latnumber | null
Latitude, in WGS 84. Requires lon.
lonnumber | null
Longitude, in WGS 84. Requires lat.
parcelstring | null
A parcel id. Zoning is looked up at the parcel's center.
bboxstring | null
A bounding box, as west,south,east,north in WGS 84. Results are limited to classifications that intersect it.
jurisdictionstring | null
A jurisdiction id. Results are limited to classifications it adopted or that lie wholly or partly within it.
fipsstring | null
A Census GEOID: 2 digits for a state or 5 for a county, such as 48 or 48453. Results are limited to classifications that lie wholly or partly within it.
codestring | null
A district code, such as R-1. Requires jurisdiction or fips.
kind"base" | "overlay" | null
District type. One of base or overlay.
usestring | null
A use, as named in the ordinance. Results are limited to classifications whose allowances list it.
result"permitted" | "conditional" | "prohibited" | "unknown" | null
The result for use. One of permitted, conditional, prohibited or unknown. Requires use.
legal_status"adopted" | "proposed" | null
Legal status. One of adopted or proposed. Defaults to adopted.
includestring | null
Comma-separated sections to include. Any of allowance (allowances), standard (standards) and geometry (every mapped area, as GeoJSON).
format"json" | "geojson"
Response format. One of json (a list) or geojson (a FeatureCollection). Defaults to json. Accept: application/geo+json also selects geojson.
cursorstring | null
A cursor for pagination: the next_cursor from the previous page.
sizeinteger | null
Number of results per page, between 1 and 200. Defaults to 20.
totalboolean
Whether to include total, the count of all matches, on the first page. Defaults to false.

Responses

200
array of zoning objects
A page of zoning classifications.
401
ProblemDetail
credential_missing, credential_invalid or credential_expired. The request has no valid credential.
402
ProblemDetail
quota_exhausted. The credit balance is too low for this request. Nothing is charged.
403
ProblemDetail
scope_missing, person_required, api_key_not_accepted or entitlement_missing. The credential or plan does not allow this request. detail names the reason.
404
ProblemDetail
no_such_resource. No parcel matches parcel.
422
ProblemDetail
parameter_invalid, id_malformed or a cursor code. A parameter is missing or invalid. errors lists each one.
429
ProblemDetail
rate_limited. Too many requests. Retry after the Retry-After interval. Nothing is charged.
501
ProblemDetail
not_available. Zoning data is not available yet.

Credits

1 credit per location. 1 credit per 20 results for a list by jurisdiction or fips. Repeat requests within 24 hours are free.

Example request

curl -G 'https://api.placestack.com/v1/zoning' \
  --data-urlencode 'address=4516 Printer Ln, Raleigh, NC 27613' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY"

Example response

{
  "object": "list",
  "data": [
    {
      "object": "zoning",
      "id": "zon_01h455vb4pex5vsknk084sn02q",
      "code": "R-4",
      "name": "Residential-4",
      "kind": "base",
      "applies_over": {
        "scope": "all",
        "codes": [
          "R-4",
          "R-6"
        ],
        "citation": {
          "section": "2.2.1",
          "passage": "The R-4 district is intended for single-unit living at up to 4 units per acre.",
          "url": "https://udo.raleighnc.gov/book/export/html/76",
          "effective": "2013-09-01"
        }
      },
      "precedence": {
        "rank": 1,
        "basis": "stated",
        "citation": {
          "section": "2.2.1",
          "passage": "The R-4 district is intended for single-unit living at up to 4 units per acre.",
          "url": "https://udo.raleighnc.gov/book/export/html/76",
          "effective": "2013-09-01"
        }
      },
      "jurisdiction": {
        "id": "jur_01h455vb4pex5vsknk084sn02q",
        "name": "Raleigh",
        "type": "city",
        "fips": "3755000",
        "href": "/v1/jurisdiction/jur_01h455vb4pex5vsknk084sn02q"
      },
      "within": [
        {
          "id": "jur_01h455vb4pex5vsknk084sn02q",
          "name": "Wake",
          "tier": "subregion",
          "type": "county",
          "fips": "37183"
        }
      ],
      "category": {
        "code": "R",
        "description": "Residential"
      },
      "purpose": "Residential-4 is primarily intended for single-unit living, at up to 4 units per acre.",
      "ordinance": {
        "citation": "Raleigh Unified Development Ordinance",
        "section": "2.2.1",
        "url": "https://udo.raleighnc.gov/book/export/html/76",
        "adopted": "2013-02-18",
        "effective": "2013-09-01"
      },
      "effective": {
        "from": "2013-09-01",
        "to": "2026-09-13"
      },
      "legal_status": "adopted",
      "mapped_area_m2": 153558663.9,
      "allowances": [
        {
          "use": {
            "code": "1100",
            "name": "Two-unit living",
            "category": "Household Living"
          },
          "result": "conditional",
          "qualification": "See the definitions and use standards in Sec. 6.2.1.B.",
          "process": "Conditional use permit",
          "citation": {
            "section": "2.2.1",
            "passage": "The R-4 district is intended for single-unit living at up to 4 units per acre.",
            "url": "https://udo.raleighnc.gov/book/export/html/76",
            "effective": "2013-09-01"
          }
        }
      ],
      "unlisted_uses": {
        "result": "permitted",
        "process": "Use Determination by the Zoning Administrator",
        "citation": {
          "section": "2.2.1",
          "passage": "The R-4 district is intended for single-unit living at up to 4 units per acre.",
          "url": "https://udo.raleighnc.gov/book/export/html/76",
          "effective": "2013-09-01"
        }
      },
      "standards": [
        {
          "type": "setback_front",
          "label": "D1 Principal building (max)",
          "value": {
            "min": 10,
            "max": 40,
            "unit": "ft"
          },
          "text": "20 feet from the right-of-way",
          "qualification": "Applies to lots created after September 1, 2013.",
          "citation": {
            "section": "2.2.1",
            "passage": "The R-4 district is intended for single-unit living at up to 4 units per acre.",
            "url": "https://udo.raleighnc.gov/book/export/html/76",
            "effective": "2013-09-01"
          }
        }
      ],
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -78.6999,
              35.849
            ],
            [
              -78.6993,
              35.849
            ],
            [
              -78.6993,
              35.8494
            ],
            [
              -78.6999,
              35.8494
            ],
            [
              -78.6999,
              35.849
            ]
          ]
        ]
      },
      "sources": [
        {
          "kind": "map",
          "url": "https://maps.raleighnc.gov/arcgis/rest/services/Planning/Zoning/MapServer/0",
          "acquired": "2026-10-01"
        }
      ],
      "as_of": "2026-10-01",
      "href": "/v1/zoning/zon_01h455vb4pex5vsknk084sn02q"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJrIjoiMjAyNi0xMC0wMSIsInQiOjQyfQ",
  "suppressed": 0,
  "total": {
    "value": 1,
    "relation": "eq"
  }
}

Next steps

GET /zoning/{zoning_id}

Retrieve a zoning classification

Continue