Skip to content

API

Blecon Track is built entirely on the API. Every feature in the Blecon Track dashboard (the live map, trails, rules, zone management, alerts) uses these same endpoints. Anything you can do in Blecon Track, 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 Blecon 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 Authorization header.

You can create and manage API keys directly from the Blecon Track dashboard: open Workspace Settings and go to the 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 tag 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 Settings → Network zones and appear in Blecon 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 tag registration via the Blecon Agent.
  • Hotspots: Register and manage fixed hotspots, matching the Network page in the Blecon Track dashboard. Requires the Enterprise tier.

Building on the API

Blecon 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 tags from your own mobile app (see scanner integration).

Questions? Contact Blecon support — we're happy to help.