Skip to content

Get devices

Request

Retrieves devices (tablets, phones, laptops) registered to care homes for logging activities.

All ObjectId reference fields are populated one level deep with { id, name }.

The homes array in the response is filtered to only include entries for homes the API key has access to.

Filters:

  • type - Filter by device type (tablet, phone, laptop)
  • deviceStatus - Filter by home assignment status (pending, approved, blocked)
  • startDate, endDate - Date range filtering on createdOn
  • page, limit - Pagination controls (default: page=1, limit=10, max=100)
Security
bearer
Query
startDatestring, (date)

Start date for filtering (inclusive)

Example:startDate=2026-01-01
endDatestring, (date)

End date for filtering (inclusive)

Example:endDate=2026-12-31
pagenumber, >= 1

Page number (1-based)

Default:1
Example:page=1
limitnumber, [ 1 .. 100 ]

Number of records per page

Default:10
Example:limit=10
typestring

Filter by device type

Enum:"tablet""phone""laptop"
Example:type=tablet
deviceStatusstring

Filter by device home assignment status. If not provided, returns devices with any status.

Enum:"pending""approved""blocked"
Example:deviceStatus=approved
GET
/api/devices
curl -i -X GET \
  'https://data.logmycare.co.uk/openapi/api/devices?startDate=2026-01-01&endDate=2026-12-31&page=1&limit=10&type=tablet&deviceStatus=approved'

Responses

Successfully retrieved records

Bodyapplication/json
dataArray of objectsrequired

Array of devices

Example:
[
  {
    "id": "64f8a1b23d4e5f6a7b8c9d0e",
    "name": "Reception Tablet",
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "version": "4.2.1",
    "model": "iPad Pro 12.9",
    "type": "tablet",
    "users": [ … ],
    "homes": [ … ],
    "lastUsedBy": { … },
    "lastUsedOn": "2026-03-07T14:30:00.000Z",
    "createdBy": { … },
    "createdOn": "2026-01-15T10:00:00.000Z",
    "editedBy": { … },
    "editedOn": "2026-03-07T14:30:00.000Z"
  }
]
paginationobject(PaginationMetaDto)required

Pagination metadata

Response
{
  "data": [
    { … }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 150,
    "totalPages": 15,
    "hasNext": true,
    "hasPrev": false
  }
}