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
get
GET /events/events 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

Last updated