# Areas

A Curb Area represents a specific neighborhood or area of interest in a city that includes one or more Curb Zones. Unlike Curb Zones, Curb Areas can overlap with each other, and the same Curb Zone can be part of multiple Curb Areas. These areas are intended to focus on specific regions within a city rather than covering the entire city. Curb Areas can be updated as needed, with cities optionally assigning a new curb\_area\_id when changes occur.

## GET /curbs/areas

> Query Curb Areas

```json
{"openapi":"3.1.0","info":{"title":"CurbIQ API","version":"1.0.0"},"servers":[{"url":"https://v2.curbiq-curb-api.io","description":"CurbIQ's Curb API (v1)"}],"paths":{"/curbs/areas":{"get":{"operationId":"getCurbArea","summary":"Query Curb Areas","parameters":[{"name":"curbiq_token","in":"query","required":true,"schema":{"type":"string"},"description":"The CurbIQ token provided to you when you registered for the API."},{"name":"lat","in":"query","required":false,"description":"CDS  \nLatitude at the center of the search circle.  \nThis parameter is conditionally required if either 'lng' or 'radius' is specified.\n","schema":{"type":"number","format":"float"}},{"name":"lng","in":"query","required":false,"description":"CDS  \nLongitude at the center of the search circle.  \nThis parameter is conditionally required if either 'lng' or 'radius' is specified.\n","schema":{"type":"number","format":"float"}},{"name":"radius","in":"query","required":false,"description":"CDS  \nRadius of the search circle (in centimeters).  \nThis parameter is conditionally required if either 'lng' or 'radius' is specified.\n","schema":{"type":"number","format":"float"}},{"name":"min_lat","in":"query","required":false,"description":"CDS  \nFor querying policies associated with all zones within a bounding box.  \nIf any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.  \nIf specified only return Curb Zones that intersect the supplied bounding box.\n","schema":{"type":"number","format":"float"}},{"name":"min_lng","in":"query","required":false,"description":"CDS  \nFor querying policies associated with all zones within a bounding box.  \nIf any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.  \nIf specified only return Curb Zones that intersect the supplied bounding box.\n","schema":{"type":"number","format":"float"}},{"name":"max_lat","in":"query","required":false,"description":"CDS  \nFor querying policies associated with all zones within a bounding box.  \nIf any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.  \nIf specified only return Curb Zones that intersect the supplied bounding box.\n","schema":{"type":"number","format":"float"}},{"name":"max_lng","in":"query","required":false,"description":"CDS  \nFor querying policies associated with all zones within a bounding box.  \nIf any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.  \nIf specified only return Curb Zones that intersect the supplied bounding box.\n","schema":{"type":"number","format":"float"}},{"name":"curb_area_id","in":"query","required":false,"description":"CCDS  \nThe ID of a Curb Area. If specified, only return the specified curb area.\n","schema":{"type":"string","format":"uuid"}},{"name":"name","in":"query","required":false,"description":"CCDS  \nName of the area being queried. If specified, only return the specified curb area.\n","schema":{"type":"string"}},{"name":"response_size","in":"query","required":false,"description":"CCDS  \nDefault is 100. The maximum response size is 250.\n","schema":{"type":"integer"}},{"name":"page_num","in":"query","required":false,"description":"CCDS  \nPage number for paginated responses, default is 1.\n","schema":{"type":"integer"}}],"responses":{"200":{"description":"A successful response containing Curb Areas.","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"time_zone":{"type":"string"},"last_updated":{"type":"number"},"currency":{"type":"string"},"author":{"type":"string"},"licence_url":{"type":"string","nullable":true},"ccds_attributes":{"type":"object","properties":{"type":{"type":"string"},"request_type":{"type":"string"},"query_parameters":{"type":"object","properties":{"curbiq_token":{"type":"string"}}}}},"pages":{"type":"object","properties":{"total":{"type":"integer"},"current":{"type":"integer"}}},"data":{"type":"array","items":{"type":"object","properties":{"areas":{"type":"array","items":{"type":"object","properties":{"curb_area_id":{"type":"string"},"name":{"type":"string"},"published_date":{"type":"integer"},"last_updated_date":{"type":"integer"},"curb_zone_ids":{"type":"array","items":{"type":"string"}}}}}}}}}}}}},"400":{"description":"Bad request. Error in the query parameters such as an invalid token."}},"tags":["curbs"]}}}}
```

## Fetch Curb Area

> Fetch all the information about an area using its CDS \`curb\_area\_id\`. This API is great if you know exactly what curb area you need information for. A quick query will return all the relevant regulation data for the curb area specified.<br>

```json
{"openapi":"3.1.0","info":{"title":"CurbIQ API","version":"1.0.0"},"servers":[{"url":"https://v2.curbiq-curb-api.io","description":"CurbIQ's Curb API (v1)"}],"paths":{"/curbs/areas/{curb_area_id}":{"get":{"operationId":"getCurbAreabyID","summary":"Fetch Curb Area","description":"Fetch all the information about an area using its CDS `curb_area_id`. This API is great if you know exactly what curb area you need information for. A quick query will return all the relevant regulation data for the curb area specified.\n","parameters":[{"name":"curb_area_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"The unique identifier for the Curb Area."},{"name":"curbiq_token","in":"query","required":true,"schema":{"type":"string"},"description":"The CurbIQ token provided to you when you registered for the API."},{"name":"lat","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Latitude at the center of the search circle."},{"name":"lng","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Longitude at the center of the search circle."},{"name":"radius","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Radius of the search circle (in centimeters)."},{"name":"min_lat","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Min latitude for bounding box search. If any of min_lat, min_lng, max_lat, max_lng are specified, all must be."},{"name":"min_lng","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Min longitude for bounding box search. If any of min_lat, min_lng, max_lat, max_lng are specified, all must be."},{"name":"max_lat","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Max latitude for bounding box search. If any of min_lat, min_lng, max_lat, max_lng are specified, all must be."},{"name":"max_lng","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Max longitude for bounding box search. If any of min_lat, min_lng, max_lat, max_lng are specified, all must be."},{"name":"name","in":"query","required":false,"schema":{"type":"string"},"description":"Name of the curb area."},{"name":"response_size","in":"query","required":false,"schema":{"type":"integer","default":100},"description":"Default is 100. Max is 250."},{"name":"page_num","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"Page number for paginated responses."}],"responses":{"200":{"description":"A successful response containing Curb Areas.","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"time_zone":{"type":"string"},"last_updated":{"type":"number"},"currency":{"type":"string"},"author":{"type":"string"},"licence_url":{"type":"string","nullable":true},"ccds_attributes":{"type":"object","properties":{"type":{"type":"string"},"request_type":{"type":"string"},"query_parameters":{"type":"object","properties":{"curb_area_id":{"type":"string"},"curbiq_token":{"type":"string"},"include_geometry":{"type":"boolean"}}}}},"pages":{"type":"object","properties":{"total":{"type":"integer"},"current":{"type":"integer"}}},"data":{"type":"array","items":{"type":"object","properties":{"areas":{"type":"array","items":{"type":"object","properties":{"curb_area_id":{"type":"string"},"geometry":{"type":"array","items":{"type":"array","items":{"type":"number","format":"float"}}},"name":{"type":"string"},"published_date":{"type":"integer"},"last_updated_date":{"type":"integer"},"curb_zone_ids":{"type":"array","items":{"type":"string"}}}}}}}}}}}}},"400":{"description":"Request failed."}},"tags":["curbs"]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://curbiq.gitbook.io/curbiq-api-documentation/curbs/curbs_areas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
