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.

Query Curb Spaces

get

Query parameters

curbiq_tokenstringRequired

The CurbIQ token provided to you when you registered for the API.

zonestring · uuidOptional

CDS The ID of a Curb Zone. If specified, only return Curb Spaces contained within this zone.

latnumber · floatOptional

CDS Latitude at the center of the search circle. Required if 'lng' or 'radius' is specified.

lngnumber · floatOptional

CDS Longitude at the center of the search circle. Required if 'lat' or 'radius' is specified.

radiusnumber · floatOptional

CDS Radius of the search circle (in centimeters). Required if 'lat' or 'lng' is specified.

min_latnumber · floatOptional

CDS Bounding box query. If any of min_lat, min_lng, max_lat, max_lng are specified, all must be.

min_lngnumber · floatOptional

Same as above.

max_latnumber · floatOptional

Same as above.

max_lngnumber · floatOptional

Same as above.

timeinteger · int64Optional

CDS Only return Curb Zones valid at this timestamp (in ms).

Example: 1643130000000

response_sizeintegerOptional

CCDS Maximum is 250.

Default: 100

page_numintegerOptional

CCDS Page number for paginated responses.

Default: 1

Responses

200

A successful response containing Curb Spaces.

application/json

400

Bad request. Invalid query parameters.

get

/curbs/spaces

HTTPcURLJavaScriptPython

GET /curbs/spaces?curbiq_token=text HTTP/1.1
Host: v2.curbiq-curb-api.io
Accept: */*

{
  "version": "1.0.1",
  "time_zone": "US/Eastern",
  "last_updated": 1706043881390,
  "currency": "USD",
  "author": "CurbIQ",
  "licence_url": "text",
  "ccds_attributes": {
    "type": "curbiq_api_response",
    "request_type": "spaces",
    "query_parameters": {
      "curbiq_token": "curbiq_token"
    }
  },
  "pages": {
    "total": 1,
    "current": 1
  },
  "data": [
    {
      "spaces": [
        {
          "curb_space_id": "348357c3-ee1c-44a2-acea-00fea37fae6c",
          "name": "arlington_area_1",
          "published_date": 1706044048915,
          "last_updated_date": 1706043881390,
          "curb_zone_id": [
            "00c291e4-2506-42cd-887e-8de1d3b3d0ca"
          ],
          "space_number": 1,
          "length": null,
          "width": null,
          "available": false,
          "availability_time": null
        }
      ]
    }
  ]
}

Fetch Curb Space

get

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.

Path parameters

curb_space_idstring · uuidRequired

The unique identifier for the Curb Space.

Query parameters

curbiq_tokenstringRequired

The CurbIQ token provided to you when you registered for the API.

timeinteger · int64Optional

CDS
The Curb Zone object will only be returned if its validity period includes this time.
This parameter takes a time in the Timestamp format in milliseconds Otherwise, the server should reply with 404 Not Found. Availability data (if supplied) will be returned as of this time.

Example: 1643130000000

response_sizeintegerOptional

CCDS
Default is 100. The maximum response size is 250.

page_numintegerOptional

CCDS
Page number for paginated responses, default is 1.

Responses

200

A successful response containing Curb Spaces.

application/json

400

Bad request. Error in the query parameters such as an invalid token.

get

/curbs/spaces/{curb_space_id}

HTTPcURLJavaScriptPython

GET /curbs/spaces/{curb_space_id}?curbiq_token=text HTTP/1.1
Host: v2.curbiq-curb-api.io
Accept: */*

{
  "version": "1.0.1",
  "time_zone": "US/Eastern",
  "last_updated": 1706043881390,
  "currency": "USD",
  "author": "CurbIQ",
  "licence_url": "text",
  "ccds_attributes": {
    "type": "curbiq_api_response",
    "request_type": "spaces",
    "query_parameters": {
      "curbiq_token": "curbiq_token",
      "curb_space_id": "2f247f37-8775-4ca1-a7a8-3bbb635371ee"
    }
  },
  "pages": {
    "total": 1,
    "current": 1
  },
  "data": [
    {
      "spaces": [
        {
          "curb_space_id": "2f247f37-8775-4ca1-a7a8-3bbb635371ee",
          "name": "arlington_area_1",
          "published_date": 1706044048915,
          "last_updated_date": 1706043881390,
          "curb_zone_id": [
            "00c291e4-2506-42cd-887e-8de1d3b3d0ca"
          ],
          "space_number": 1,
          "length": "text",
          "width": "text",
          "available": false,
          "availability_time": null
        }
      ]
    }
  ]
}