API
Bike traffic counters
Public access to bike counter locations and historical traffic measurements.
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
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
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}
]
}