API

Bike traffic counters

Organization: Kielce City Hall 2 endpoints Technical name: bike-counter Version: v1 Managed Public

Public access to bike counter locations and historical traffic measurements.

Tags

  • Bicycle
  • Transport and mobility

Documentation

The API exposes the counter list and hourly readings stored by the Bike Counter module. Date ranges use the requested timezone and default to UTC.

API endpoints

GET /counters Counter list json

Returns counters with their WGS 84 location, provider and operating range.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Mobility
Tags Bicycle, Transport and mobility
Data sources Eco-Visio
Try endpoint

Endpoint

/api/public/bike-counter/counters?version=v1
Request
GET /api/public/bike-counter/counters
Response
[
  {
    "uri": "https://data.example.test/api/public/bike-counter/counters#krakowska",
    "id": "krakowska",
    "name": "Krakowska",
    "provider": "private",
    "externalId": null,
    "location": {"lat": 50.8501, "lon": 20.6154},
    "activeFrom": "2025-11-01T00:00:00+00:00",
    "activeTo": null,
    "lastSynchronizedAt": "2026-08-25T12:00:00+00:00"
  }
]
GET /counters/{counterId}/readings Counter readings json

Returns historical readings for a selected counter and date range.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Mobility
Tags Bicycle, Transport and mobility
Data sources Eco-Visio
Try endpoint

Endpoint

/api/public/bike-counter/counters/{counterId}/readings?version=v1

Parameters

Name Location Type Required Description example
counterId path string required Counter identifier. krakowska
from query date required First range day in YYYY-MM-DD format. 2026-08-01
to query date required Last range day in YYYY-MM-DD format. 2026-08-02
timezone query string optional Optional IANA timezone used to interpret the range and present timestamps. Europe/Warsaw
Request
GET /api/public/bike-counter/counters/krakowska/readings?from=2026-08-01&to=2026-08-02&timezone=Europe/Warsaw
Response
{
  "uri": "https://data.example.test/api/public/bike-counter/counters/krakowska/readings?from=2026-08-01&to=2026-08-02",
  "counterUri": "https://data.example.test/api/public/bike-counter/counters#krakowska",
  "counterId": "krakowska",
  "readings": [
    {"readAt": "2026-08-01T12:00:00+02:00", "value": 42}
  ]
}