---
title: "GET /rest/v1/devices"
method: GET
path: "/rest/v1/devices"
---

# GET /rest/v1/devices

`GET /rest/v1/devices`

Retrieves a list of devices. Filter by location using the locationId parameter.

## Query parameters

- `locationId` string — The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.
- `page` number — Integers that will have a value greater than 0.
- `perPage` number — Integers that will have a value greater than 0.

## Response `default`

[Device!]!

- object
  - `data` Device[], required
    - `id` string, required — The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.
    - `name` string — The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
    - `alias` string — The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
    - `deviceType` string — The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
    - `osVersion` string — The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
    - `appVersion` string — The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
    - `ipAddress` string — The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
    - `wifiNetwork` string — The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
    - `isConnected` boolean — The `Boolean` scalar type represents `true` or `false`.
    - `lastHeartbeatAt` string, date-time — A date-time string at UTC, such as 2007-12-03T10:15:30Z, compliant with the `date-time` format outlined in section 5.6 of the RFC 3339 profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar.
    - `printerStatus` string — The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
    - `isSleeping` boolean — The `Boolean` scalar type represents `true` or `false`.
    - `locationId` string — The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.
    - `createdAt` string, date-time — A date-time string at UTC, such as 2007-12-03T10:15:30Z, compliant with the `date-time` format outlined in section 5.6 of the RFC 3339 profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar.
    - `updatedAt` string, date-time — A date-time string at UTC, such as 2007-12-03T10:15:30Z, compliant with the `date-time` format outlined in section 5.6 of the RFC 3339 profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar.
  - `meta` object
    - `messages` string[] — Optional scope information.
    - `page` integer — The page of results this response represents.
    - `perPage` integer — The number of results per page.
    - `total` integer — The total number of results across all pages.

---

[API](https://skmtc.net/envoy/apis/envoy-developer-api.md) · [All operations](https://skmtc.net/envoy/apis/envoy-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/envoy/envoy-developer-api/revisions/51c85bc66c44/schema)