> For the complete documentation index, see [llms.txt](https://curbiq.gitbook.io/curbiq-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://curbiq.gitbook.io/curbiq-api-documentation/curbs/curbs_spaces.md).

# Spaces

A Curb Space refers to an individual, demarcated area within a Curb Zone designated for specific vehicle use, such as parking. Each Curb Space must be entirely contained within a single Curb Zone and cannot overlap with other Curb Spaces to maintain clear regulations. Unlike Curb Zones, which have fixed boundaries, Curb Spaces can be updated as needed, allowing cities to assign a new curb\_space\_id to reflect changes. This flexibility ensures that parking regulations can adapt to evolving urban needs while keeping the management of curb space organized and efficient.

## GET /curbs/spaces

> Query Curb Spaces

```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/spaces":{"get":{"operationId":"getCurbSpace","summary":"Query Curb Spaces","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":"zone","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"CDS   The ID of a Curb Zone. If specified, only return Curb Spaces contained within this zone.\n"},{"name":"lat","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"CDS   Latitude at the center of the search circle.   Required if 'lng' or 'radius' is specified.\n"},{"name":"lng","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"CDS   Longitude at the center of the search circle.   Required if 'lat' or 'radius' is specified.\n"},{"name":"radius","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"CDS   Radius of the search circle (in centimeters).   Required if 'lat' or 'lng' is specified.\n"},{"name":"min_lat","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"CDS   Bounding box query.   If any of min_lat, min_lng, max_lat, max_lng are specified, all must be.\n"},{"name":"min_lng","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Same as above."},{"name":"max_lat","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Same as above."},{"name":"max_lng","in":"query","required":false,"schema":{"type":"number","format":"float"},"description":"Same as above."},{"name":"time","in":"query","required":false,"schema":{"type":"integer","format":"int64"},"description":"CDS   Only return Curb Zones valid at this timestamp (in ms).\n"},{"name":"response_size","in":"query","required":false,"schema":{"type":"integer","default":100},"description":"CCDS   Maximum is 250.\n"},{"name":"page_num","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"CCDS Page number for paginated responses."}],"responses":{"200":{"description":"A successful response containing Curb Spaces.","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":{"spaces":{"type":"array","items":{"type":"object","properties":{"curb_space_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"published_date":{"type":"integer"},"last_updated_date":{"type":"integer"},"curb_zone_id":{"type":"array","items":{"type":"string","format":"uuid"}},"space_number":{"type":"integer"},"length":{"type":"string","nullable":true},"width":{"type":"string","nullable":true},"available":{"type":"boolean"},"availability_time":{"type":"number","nullable":true}}}}}}}}}}}},"400":{"description":"Bad request. Invalid query parameters."}},"tags":["curbs"]}}}}
```

## Fetch Curb Space

> Fetch all the information about a space using its CDS curb\_space\_id. This API is useful if you know exactly what curb space you need information for. A quick query will return all the relevant regulation data for the specified curb space.

```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/spaces/{curb_space_id}":{"get":{"operationId":"getCurbSpaceByID","summary":"Fetch Curb Space","description":"Fetch all the information about a space using its CDS curb_space_id. This API is useful if you know exactly what curb space you need information for. A quick query will return all the relevant regulation data for the specified curb space.","parameters":[{"name":"curb_space_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"The unique identifier for the Curb Space."},{"name":"curbiq_token","in":"query","required":true,"schema":{"type":"string"},"description":"The CurbIQ token provided to you when you registered for the API."},{"name":"time","in":"query","required":false,"schema":{"type":"integer","format":"int64"},"description":"CDS  \nThe Curb Zone object will only be returned if its validity period includes this time.  \nThis parameter takes a time in the [Timestamp](https://github.com/openmobilityfoundation/curb-data-specification/blob/main/general-information.md#timestamp) format in milliseconds\nOtherwise, the server should reply with 404 Not Found. Availability data (if supplied) will be returned as of this time.\n"},{"name":"response_size","in":"query","required":false,"schema":{"type":"integer"},"description":"CCDS  \nDefault is 100. The maximum response size is 250.\n"},{"name":"page_num","in":"query","required":false,"schema":{"type":"integer"},"description":"CCDS  \nPage number for paginated responses, default is 1.\n"}],"responses":{"200":{"description":"A successful response containing Curb Spaces.","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"},"curb_space_id":{"type":"string"}}}}},"pages":{"type":"object","properties":{"total":{"type":"integer"},"current":{"type":"integer"}}},"data":{"type":"array","items":{"type":"object","properties":{"spaces":{"type":"array","items":{"type":"object","properties":{"curb_space_id":{"type":"string"},"name":{"type":"string"},"published_date":{"type":"integer"},"last_updated_date":{"type":"integer"},"curb_zone_id":{"type":"array","items":{"type":"string"}},"space_number":{"type":"integer"},"length":{"type":"string","nullable":true},"width":{"type":"string","nullable":true},"available":{"type":"boolean"},"availability_time":{"type":"integer","nullable":true}}}}}}}}}}}},"400":{"description":"Bad request. Error in the query parameters such as an invalid token."}},"tags":["curbs"]}}}}
```