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 the start_time and end_time parameters. The curb place parameters (curb_area_id, curb_zone_id, curb_space_id) are optional.

Query parameters

curbiq_tokenstringRequired

curb_area_idstring · uuidOptional

curb_zone_idstring · uuidOptional

curb_space_idstring · uuidOptional

start_timeinteger · int64OptionalExample: 1643130000000

end_timeinteger · int64OptionalExample: 1643130000000

response_sizeintegerOptional

page_numintegerOptional

Responses

200

A successful response containing Events.

application/json

versionstringOptionalExample: 1.0.1

time_zonestringOptionalExample: US/Eastern

last_updatedintegerOptionalExample: 1744045712000

currencystringOptionalExample: USD

authorstringOptionalExample: CurbIQ

license_urlstring · nullableOptional

400

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

get

/events/events

HTTPcURLJavaScriptPython

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

{
  "version": "1.0.1",
  "time_zone": "US/Eastern",
  "last_updated": 1744045712000,
  "currency": "USD",
  "author": "CurbIQ",
  "license_url": null,
  "ccds_attributes": {
    "type": "curbiq_api_response",
    "request_type": "status",
    "city_id": "e0e37e56-f583-492f-89c2-083a42440d9d",
    "city_name": "seattle",
    "query_parameters": {
      "curb_zone_id": "63d8fb53-c903-4553-aff5-7184096baf17",
      "curbiq_token": "curbiq_token",
      "start_time": 1643130000000,
      "end_time": 1704171600000,
      "page_num": 1,
      "response_size": 10
    }
  },
  "pages": {
    "total": 100,
    "current": 1
  },
  "data": {
    "events": [
      {
        "event_id": "2f247f37-8775-4ca1-a7a8-3bbb635371ee",
        "event_type": "park_end",
        "event_location": {
          "type": "feature",
          "properties": {
            "timestamp": 1741302839000
          },
          "geometry": {
            "type": "Point",
            "coordinates": [
              -122.341249511,
              47.617270682
            ]
          }
        },
        "event_time": 1741302094530,
        "event_publication_time": 1741303094530,
        "event_session_id": "8976dbd2-9854-47d2-a55a-376c90bc8a3d",
        "curb_zone_id": "582d023b-0110-4080-ab35-b8b391f55e36",
        "curb_area_ids": "63d8fb53-c903-4553-aff5-7184096baf1",
        "data_source_type": "above_ground",
        "data_source_operator_id": "a774fecb-2a69-4161-8847-fa0e59e8cc0f",
        "data_source_operator_name": "operator_name",
        "data_source_device_id": "1a8538fc-d40b-48fe-9b35-402996d65a95",
        "data_source_device_name": "parking_meter_23",
        "data_source_manufacturer": null,
        "data_source_model": null,
        "sensor_status_is_online": true
      }
    ]
  },
  "links": {
    "first": "https://example.com",
    "last": "https://example.com",
    "prev": "https://example.com",
    "next": "https://example.com"
  }
}

Note: Custom response limits have been placed to manage query operations/system loads and response time.

• If a curb_zone_id is not specified: end_time - start_time should not exceed one day

• If a curb_zone_id is specified: end_time - start_time should not exceed three months