LemursEye
Documentation
API

Register a tracker

POSThttps://lemurseye.com/api/v1/devices

Registers a tracker by its IMEI so its positions are accepted. Register it before the tracker starts reporting (setup per brand in Trackers): positions from an IMEI that is not registered are dropped, not kept.

A new tracker is fitted to no vehicle: positions only appear on a vehicle once you assign it.

Permission: device:write. The token is sent as Authorization: Bearer <token>; see Authentication.

Body (JSON)

  • imeistringrequired

    The tracker's IMEI (or the phone app's device ID). Unique across the platform.

  • protocolstring

    gt06, teltonika, h02, osmand or other.

  • modelstring

    Hardware model, for your records.

  • simMsisdnstring

    The SIM's phone number.

  • notesstring

    Free text.

Response

201

The registered tracker.

Response fields

  • iduuid

    The tracker's id (not its IMEI).

  • imeistring

    The identifier the tracker reports with. For the phone app, the device ID shown in the app.

  • protocolstring | null

    gt06 (Concox), teltonika, h02 (SinoTrack), osmand (the phone app) or other.

  • modelstring | null

    Hardware model, for your records.

  • simMsisdnstring | null

    The SIM's phone number.

  • statusstring

    REGISTERED, or DECOMMISSIONED once retired: its positions are then refused.

  • vehicleIduuid | null

    The vehicle it is fitted to, or null.

  • traccarIdinteger | null

    Internal id in the position bridge. Null for a moment after registering; repaired automatically.

  • notesstring | null

    Free text, e.g. where it is installed.

  • createdAttimestamp

    When it was registered.

  • decommissionedAttimestamp | null

    When it was retired, or null.

Errors

Where a message is listed, it comes back as JSON: { "error": "..." }. Otherwise only the status code is returned.

  • 400
    imei is required

    imei is missing or blank.

  • 409
    device with this IMEI already exists

    This IMEI is already registered.

  • 401

    No token, or it has expired.

  • 403

    The token lacks the permission above.

← List trackersRetrieve a tracker →