Tracker API
Blecon Track is built entirely on the Tracker API. Every feature in the Track UI (the live map, trails, rules, zone management, alerts) uses these same endpoints. Anything you can do in the Track UI, you can do programmatically via this API.
This means you can build your own tracking applications, dashboards, and automations on top of the same API that powers Track.
Base URL
https://api.blecon.net/tracker/api
All endpoints are scoped to a workspace:
https://api.blecon.net/tracker/api/workspaces/{workspace_id}/...
Authentication
- Browser sessions: Sign in to Blecon Track to authenticate interactively.
- API keys: Programmatic access via API keys. Include the key in the
Authorizationheader.
You can create and manage API keys directly from the Track UI: open Workspace Settings and go to the Track API tab.
API reference
The full interactive API reference is available at api.blecon.net/tracker/docs. It covers all endpoints with request/response schemas and lets you try calls directly.
Key resource groups:
- Assets: List assets (with tag, type, zone, and status filters), query position history, sensor history, timeline, child assets, and association history. Assets support tags and custom fields.
- Positions and trails: All device trails, location statistics, and trail density.
- Zones: Create coordinate zones, list/update/delete zones, zone tags, and zone transition history. Network zones are created in the Blecon Console and appear in Track automatically.
- Rules: Create, list, update, and delete rules.
- Alerts: List alerts (filterable by status, severity, assignee), alert statistics, acknowledge, resolve, and add notes.
- Webhook channels: Create, list, update, and delete webhook channels for alert notifications.
- Members: List workspace members, invite by email, manage roles, remove members.
- Scan sessions: Create scan sessions for device registration via the Blecon Agent.
Building on the Tracker API
Track is a reference implementation built on this API. You can use the same endpoints to:
- Build custom dashboards: query asset positions, zone occupancy, and trail data for your own UI.
- Automate alert management: create and update alert rules programmatically as your operations change.
- Integrate with business systems: pull alert data into your ERP, CMMS, or workflow tools. Acknowledge, assign, and resolve alerts programmatically (see alert lifecycle).
- Extend the scanner: use scan sessions to register devices from your own mobile app (see scanner integration).
Network API
The Network API is a lower-level API covering device registration, hotspot management, data routing, and integrations. Most Track users don't need it; it's for teams building custom integrations or managing infrastructure directly.
| Network API | Tracker API | |
|---|---|---|
| Docs | api.blecon.net/docs | api.blecon.net/tracker/docs |
| Scope | Devices, hotspots, networks, integrations | Assets, zones, rules, alerts |
| Use case | Infrastructure management | Tracking features and automations |
Both APIs use the same API key authentication.