CurbIQ API Documentation
  • 🗺️Getting Started
  • Authentication
  • Curbs
    • Zones
    • Areas
    • Spaces
    • Policies
  • Events
    • Events
    • Status
  • Metrics
    • Aggregates
Powered by GitBook
On this page
  1. Curbs

Policies

PreviousSpacesNextEvents

Last updated 3 months ago

A Policy object sets the rules for how specific users can or cannot use a particular curb at designated times. Each Curb Zone's regulations are defined by a combination of multiple Policy objects. Querying Curb Policies can provide the full set of policies.

  • GETQuery Curb Policies
  • FETCHFetch Curb Policy

Query Curb Policies

get
Query parameters
curbiq_tokenstringRequired

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

idsstring[]Optional

CDS
A list of curb policy ids to query, separated by commas.
If present, return only policies with the supplied UUIDs. Otherwise, return all policies.

zonestring · UUIDOptional

CCDS
The ID of a Curb Zone.
If specified, only return Curb Policies associated with this zone.

latnumber · floatOptional

CCDS
Latitude at the center of the search circle.
This parameter is conditionally required if either 'lng' or 'radius' is specified.

lngnumber · floatOptional

CCDS
Longitude at the center of the search circle.
This parameter is conditionally required if either 'lng' or 'radius' is specified.

radiusnumber · floatOptional

CCDS
Radius of the search circle.
This parameter is conditionally required if either 'lng' or 'radius' is specified.

min_latnumber · floatOptional

CCDS
For querying policies associated with all zones within a bounding box.
If any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.
If specified only return Curb Zones that intersect the supplied bounding box.

min_lngnumber · floatOptional

CCDS
For querying policies associated with all zones within a bounding box.
If any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.
If specified only return Curb Zones that intersect the supplied bounding box.

max_latnumber · floatOptional

CCDS
For querying policies associated with all zones within a bounding box.
If any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.
If specified only return Curb Zones that intersect the supplied bounding box.

max_lngnumber · floatOptional

CCDS
For querying policies associated with all zones within a bounding box.
If any of 'min_lat', 'min_lng', 'max_lat', or 'max_lng' are specified, all must be.
If specified only return Curb Zones that intersect the supplied bounding box.

timeinteger · int64Optional

CCDS
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
curb_policy_idstring · UUIDOptional

CCDS
The ID of a Curb Policy. If specified, only return the specified curb policy.

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 Policies.
application/json
400
Request failed.
get
GET /curbs/policies 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": null,
  "ccds_attributes": {
    "type": "curbiq_api_response",
    "request_type": "policies",
    "city_id": "768bbbf9-1ee2-45da-aafb-a44808461f86",
    "city_name": "arlington",
    "query_parameters": {
      "curb_policy_id": "a31cdc34-e2aa-4706-9c81-680245843203",
      "curbiq_token": "curbiq_token"
    }
  },
  "pages": {
    "total": 1,
    "current": 1
  },
  "data": [
    {
      "policies": [
        {
          "curb_policy_id": "04db9f03-7f4a-4787-8be0-4261b352590c",
          "published_date": 1706044048915,
          "priority": 509,
          "data_source_operator_id": null,
          "timespans": [
            {
              "days_of_week": [
                [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ]
              ],
              "months": [
                null
              ],
              "days_of_month": [
                null
              ],
              "time_of_day_start": "15:00",
              "time_of_day_end": "19:00",
              "start_date": 1704085200,
              "end_date": null,
              "designated_period": null
            }
          ],
          "rules": [
            {
              "activity": "no parking",
              "max_stay": null,
              "max_stay_unit": "minute",
              "no_return": null,
              "no_return_unit": "minute",
              "user_classes": [
                null
              ],
              "rate": {
                "rate": 0,
                "rate_unit": "hour",
                "rate_unit_period": "rolling"
              }
            }
          ]
        }
      ]
    }
  ]
}

Fetch Curb Policy

fetch
Path parameters
curb_policy_idstring · UUIDRequired

The unique identifier for the Curb Policy.

Query parameters
curbiq_tokenstringRequired

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

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 Policies.
application/json
400
Request failed.
fetch
FETCH /curbs/policies/{curb_policy_id} 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": null,
  "ccds_attributes": {
    "type": "curbiq_api_response",
    "request_type": "policies",
    "city_id": "768bbbf9-1ee2-45da-aafb-a44808461f86",
    "city_name": "arlington",
    "query_parameters": {
      "curb_policy_id": "04db9f03-7f4a-4787-8be0-4261b352590c",
      "curbiq_token": "curbiq_token"
    }
  },
  "pages": {
    "total": 1,
    "current": 1
  },
  "data": [
    {
      "policies": [
        {
          "curb_policy_id": "04db9f03-7f4a-4787-8be0-4261b352590c",
          "published_date": 1706044048915,
          "priority": 509,
          "data_source_operator_id": null,
          "timespans": [
            {
              "days_of_week": [
                [
                  "mon",
                  "tue",
                  "wed",
                  "thu",
                  "fri"
                ]
              ],
              "months": [
                null
              ],
              "days_of_month": [
                null
              ],
              "time_of_day_start": "15:00",
              "time_of_day_end": "19:00",
              "start_date": 1704085200,
              "end_date": null,
              "designated_period": null
            }
          ],
          "rules": [
            {
              "activity": "no parking",
              "max_stay": null,
              "max_stay_unit": "minute",
              "no_return": null,
              "no_return_unit": "minute",
              "user_classes": [
                null
              ],
              "rate": {
                "rate": 0,
                "rate_unit": "hour",
                "rate_unit_period": "rolling"
              }
            }
          ]
        }
      ]
    }
  ]
}