API Documentation
Programmatic access to real-time telemetry data, historical analytics, and aggregated insights for authorized partners and researchers.
Planned Capabilities
The Waypoint Telemetry API will provide secure, authenticated access to telemetry data for approved partners. Our API is currently in development and will be available to pilot partners once data collection begins.
Access live telemetry streams from deployed sensors, including visitor counts, directional flow, and environmental conditions.
Query aggregated historical data with flexible time ranges, granularity options, and filtering by location or sensor type.
All data is anonymized and aggregated. No individual tracking or personally identifiable information is collected or exposed.
Secure API keys with scoped permissions, rate limiting, and audit logging for all data access requests.
Installment Device Schema
Each monitoring installment has the following attributes associated with it. These attributes describe the physical device, its location, and operational characteristics.
| Attribute | Type | Description |
|---|---|---|
| id | integer | Unique identifier for the installment |
| address | string | Physical address or location name of the installment |
| gps_coordinates | object {lat, lng} | Geographic coordinates (latitude and longitude) |
| status | enum | Current operational status: active, proposed, or dormant |
| battery_level | integer (%) | Current battery charge percentage (0-100) |
| winter_managed | boolean | Whether the site is plowed/maintained during winter |
| has_ramp | boolean | Whether the site has a boat ramp or launch facility |
| max_capacity | integer | Maximum number of vehicle parking spots at the site |
API Endpoints
/v1/installmentsReturns a JSON array of all known installments with their full attributes.
Example Response
[
{
"id": 1,
"address": "Kinnickinnic State Park - Main Landing",
"gps_coordinates": {
"lat": 44.7892,
"lng": -92.6341
},
"status": "proposed",
"battery_level": null,
"winter_managed": true,
"has_ramp": true,
"max_capacity": 24
},
{
"id": 2,
"address": "Glen Park Access",
"gps_coordinates": {
"lat": 44.8123,
"lng": -92.6012
},
"status": "proposed",
"battery_level": null,
"winter_managed": false,
"has_ramp": false,
"max_capacity": 8
}
]/v1/installments/:id/currentReturns the current vehicle count for a specific installment.
Parameters
| id | integer (required) | The unique installment ID |
Example Response
{
"id": 1,
"address": "Kinnickinnic State Park - Main Landing",
"current_count": 12,
"max_capacity": 24,
"utilization_percent": 50,
"timestamp": "2026-02-04T14:32:00Z"
}/v1/installments/:id/historyReturns historical vehicle count data for a specific installment within the specified date range.
Parameters
| id | integer (required) | The unique installment ID |
| start_date | ISO 8601 date (required) | Start of the date range (inclusive) |
| end_date | ISO 8601 date (required) | End of the date range (inclusive) |
Example Request
GET /v1/installments/1/history?start_date=2026-06-01&end_date=2026-06-07Example Response
{
"id": 1,
"address": "Kinnickinnic State Park - Main Landing",
"date_range": {
"start": "2026-06-01",
"end": "2026-06-07"
},
"data": [
{
"date": "2026-06-01",
"hourly_counts": [0, 0, 0, 0, 0, 1, 3, 8, 14, 18, 21, 22, 24, 22, 20, 18, 14, 10, 6, 3, 1, 0, 0, 0],
"peak_count": 24,
"peak_hour": 12,
"daily_average": 9.4
},
{
"date": "2026-06-02",
"hourly_counts": [0, 0, 0, 0, 0, 2, 5, 10, 16, 20, 22, 23, 22, 20, 18, 15, 12, 8, 4, 2, 0, 0, 0, 0],
"peak_count": 23,
"peak_hour": 11,
"daily_average": 8.3
}
],
"summary": {
"total_observations": 168,
"average_daily_peak": 21.5,
"busiest_day": "2026-06-01",
"busiest_hour_overall": 12
}
}Request API Access
API access will be available to pilot partners, government agencies, and approved research institutions. If you are interested in data access for your organization, please reach out to discuss partnership opportunities.
Contact for Access