Skip to main content

List devices

GET 
/api/v1/domains/:domain_uuid/devices

Returns devices for the specified domain the caller is allowed to access.

Access rules:

  • Caller must have access to the target domain (domain scope).
  • Caller must have the device_view permission.

Compatibility note:

  • device_template is deprecated and retained for backward compatibility.
  • Use device_template_uuid as its successor.

Pagination (cursor-based):

  • Both limit and starting_after are optional.
  • If limit is not provided, it defaults to 50.
  • If starting_after is not provided, results start from the beginning.
  • If has_more is true, request the next page by passing starting_after equal to the last item's device_uuid from the previous response.

Examples:

  • First page: GET /api/v1/domains/{domain_uuid}/devices
  • Next page: GET /api/v1/domains/{domain_uuid}/devices?starting_after={last_device_uuid}
  • Custom size: GET /api/v1/domains/{domain_uuid}/devices?limit=50

Request​

Responses​

Success