Events

A Curb Event is a detailed record of activities that occur within the specific geographic boundaries defined by a Curb Zone or Curb Area. This event captures various types of actions or incidents related to curbside usage, such as parking, loading, unloading, or enforcement activities. Each Curb Event is associated with a particular location and time, providing valuable insights into how curb spaces are utilized. The data from these events can be used for real-time monitoring, historical analysis, and operational decision-making, helping cities manage and optimize curbside resources effectively.

Query Event

get

Access Events data in the Curb Data Specification format. Requires either a curb place parameter (curb_area_id, curb_zone_id, curb_space_id) or city_name along with start_time and end_time.

Query parameters

curbiq_tokenstringrequired

Required for client authentication to query the database.

curb_area_idstring · UUIDoptional

CDS
The ID of a Curb Area. If specified, only return events occurring within this area.

curb_zone_idstring · UUIDoptional

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

curb_space_idstring · UUIDoptional

CDS
The ID of a Curb Space. If specified, only return events occurring within this space.

city_namestringoptional

CCDS
The name of the city. If specified, only return events occurring within this city.
Please note: start_time and end_time are required if start_time is entered.

start_timeinteger · int64optional

CCDS
The Events object will return all events after this start_time.
Please note: city_name and end_time are required if start_time is entered.
This parameter takes a time in the Timestamp format Otherwise, the server should reply with 404 Not Found. Availability data (if supplied) will be returned as of this time.

Example: 1643130000000

end_timeinteger · int64optional

CCDS
The Events object will return all events before this end_time.
Please note: city_name and start_time are required if end_time is entered.
This parameter takes a time in the Timestamp format 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

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://v2.curbiq-curb-api.io/events/events?curbiq_token=text'

200

400

200

{
  "version": "1.0.1",
  "time_zone": "US/Eastern",
  "currency": "USD",
  "author": "CurbIQ",
  "type": "curbiq_api_response",
  "request_type": "events",
  "query_parameters": {
    "city_name": "arlington",
    "curbiq_token": "2f247f37-8775-4ca1-a7a8-3bbb635371ee",
    "start_time": 1704085200,
    "end_time": 1704171600
  },
  "pages": {
    "total": 100,
    "current": 1
  },
  "data": [
    {
      "events": [
        {
          "event_id": "2f247f37-8775-4ca1-a7a8-3bbb635371ee",
          "event_session_id": "8976dbd2-9854-47d2-a55a-376c90bc8a3d",
          "event_type": "park_end",
          "event_time": 1704090728,
          "event_publication_date": 1714090728,
          "curb_zone_id": "582d023b-0110-4080-ab35-b8b391f55e36"
        }
      ]
    }
  ]
}

A successful response containing Events.