Skip to navigation
API ReferenceStaff

List Device Mappings

Returns staff phones registered for attendance: requests waiting for approval and, with status, the devices already mapped to staff. Pending requests come first, newest first; mapped devices follow in the order staff were added.

  • status on each item is pending (waiting for approval) or approved (mapped). Mapped devices include those SalaryBox mapped automatically, without a request.
  • created_on is when the request was made. It is null for mapped devices, because the mapping time is not recorded.
  • Rejected requests are deleted, so declined devices cannot be listed.

Authentication

AuthorizationApi-Key

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

Query parameters

statusenumOptionalDefaults to current

Which records to return. Defaults to current.

  • current: requests waiting for approval.
  • approved: devices mapped to staff.
  • all: both.
Allowed values:
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

datalist of objects
messagestring
statusboolean
countinteger
prevstring or null
nextstring or null