# 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"]}}}} ``` --- # 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_spaces.md?ask= ``` 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.