---
title: "GET /endpoints/devices/"
method: GET
path: "/endpoints/devices/"
tags: ["endpoints"]
---

# GET /endpoints/devices/

`GET /endpoints/devices/`

Mixin to add a used_by endpoint to return a list of all objects using this object

## Query parameters

- `identifier` string
- `name` string
- `ordering` string
- `page` integer
- `page_size` integer
- `search` string

## Response `200`

- PaginatedEndpointDeviceList
  - `pagination` Pagination, required
    - `next` number, required
    - `previous` number, required
    - `count` number, required
    - `current` number, required
    - `total_pages` number, required
    - `start_index` number, required
    - `end_index` number, required
  - `results` EndpointDevice[], required
    - `device_uuid` string, uuid
    - `pbm_uuid` string, uuid, required
    - `name` string, required
    - `access_group` string, uuid, nullable
    - `access_group_obj` DeviceAccessGroup
      - `pbm_uuid` string, uuid, required
      - `name` string, required
      - `attributes` object
    - `expiring` boolean
    - `expires` string, date-time, nullable
    - `facts` DeviceFactSnapshot, required
      - `data` DeviceFacts, required
        - `os` OperatingSystem — For example: {"family":"linux","name":"Ubuntu","version":"24.04.3 LTS (Noble Numbat)","arch":"amd64"} {"family": "windows","name":"Server 2022 Datacenter","version":"10.0.20348.4405","arch":"amd64"} {"family": "windows","name":"Server 2022 Datacenter","version":"10.0.20348.4405","arch":"amd64"} {"family": "mac_os", "name": "", "version": "26.2", "arch": "arm64"}
          - `family` 'linux' | 'unix' | 'bsd' | 'windows' | 'mac_os' | 'android' | 'i_os' | 'other', required
          - `name` string — Operating System name, such as 'Server 2022' or 'Ubuntu'
          - `version` string — Operating System version, must always be the version number but may contain build name
          - `arch` string
        - `disks` Disk[], nullable
          - `name` string, required
          - `mountpoint` string, required
          - `label` string
          - `capacity_total_bytes` integer
          - `capacity_used_bytes` integer
          - `encryption_enabled` boolean
        - `network` Network
          - `hostname` string, required
          - `firewall_enabled` boolean
          - `interfaces` NetworkInterface[], required
            - `name` string, required
            - `hardware_address` string, required
            - `ip_addresses` string[]
            - `dns_servers` string[]
          - `gateway` string
        - `hardware` Hardware
          - `model` string
          - `manufacturer` string
          - `serial` string, required
          - `cpu_name` string
          - `cpu_count` integer
          - `memory_bytes` integer
        - `software` Software[], nullable
          - `name` string, required
          - `version` string
          - `source` string, required
          - `path` string
        - `processes` Process[], nullable
          - `id` integer, required
          - `name` string, required
          - `user` string
        - `users` DeviceUser[], nullable
          - `id` string, required
          - `username` string
          - `name` string
          - `home` string
        - `groups` DeviceGroup[], nullable
          - `id` string, required
          - `name` string
        - `vendor` object
      - `connection` string, uuid, required
      - `created` string, date-time, required
      - `expires` string, date-time, nullable, required
      - `vendor` 'goauthentik.io/@merged' | 'goauthentik.io/platform' | 'fleetdm.com' | 'chrome.google.com', required
    - `attributes` object
  - `autocomplete` Autocomplete, required

## Other responses

- `400`
- `403`

---

[API](https://skmtc.dev/goauthentik/apis/authentik.md) · [All operations](https://skmtc.dev/goauthentik/apis/authentik/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goauthentik/authentik/revisions/4e42e86021d7/schema)