List Latest Staff Locations | SalaryBox

{
  "data": [
    {
      "salarybox_id": "SBK7Q2M9TX",
      "name": "Aarav Sharma",
      "latitude": "12.971599",
      "longitude": "77.594566",
      "address": "MG Road, Bengaluru, Karnataka 560001",
      "location_time": "2026-10-29T11:42:10+05:30",
      "is_tracking_active": true,
      "tracking_started_at": "2026-10-29T09:00:00+05:30",
      "tracking_ended_at": null,
      "stopped_by": null
    },
    {
      "salarybox_id": "SBK3H8D1LP",
      "name": "Priya Nair",
      "latitude": "19.076090",
      "longitude": "72.877426",
      "address": null,
      "location_time": "2026-10-28T17:55:42+05:30",
      "is_tracking_active": false,
      "tracking_started_at": "2026-10-28T10:00:00+05:30",
      "tracking_ended_at": "2026-10-28T18:00:00+05:30",
      "stopped_by": "EXPIRED"
    }
  ],
  "message": "Success",
  "status": true,
  "count": 2,
  "prev": null,
  "next": null
}

Returns each tracked staff member’s last known position, as on the live map in the app. Requires the Location Tracking add-on.

Uses each person’s most recent approved tracking session. Staff never tracked are not listed. is_tracking_active says whether the session is still running; if not, stopped_by says why.

Authentication

AuthorizationApi-Key

Format: “Api-Key {api-key}”

Query parameters

salarybox_idslist of stringsOptional

Repeatable. Limits the result to these staff members, for example salarybox_ids=SBK7Q2M9TX&salarybox_ids=SBK3H8D1LP.

pageintegerOptional

Page number, starting at 1.

page_sizeintegerOptional

Results per page. Default and maximum 500.

Response

The latest known position of each tracked staff member.

datalist of objects

messagestringOptional

statusbooleanOptional

countintegerOptional

Total number of results across all pages.

prevstring or nullOptional

URL of the previous page, or null.

nextstring or nullOptional

URL of the next page, or null.

Errors

403

Forbidden Error