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

# GET /v2/devices

`GET /v2/devices`

Returns devices belonging to current user according to given parameters

## Query parameters

- `limit` integer
- `offset` integer

## Headers

- `X-Caliopen-PI` string, required

## Response `200`

Devices returned

- object
  - `total` integer — number of devices found for current user for the given parameters
  - `devices` Device[]
    - `device_id` string, required
    - `date_insert` string, date-time, required
    - `date_revoked` string, date-time
    - `ip_creation` string
    - `name` string, required
    - `privacy_features` PrivacyFeatures
    - `pi` PI
      - `technic` integer
      - `context` integer
      - `comportment` integer
      - `version` integer
    - `status` string, required
    - `type` string, required
    - `user_id` string, required
    - `user_agent` string
    - `locations` DeviceLocation[]
      - `address` string, required
      - `country` string
      - `device_id` string
      - `type` 'other' | 'home' | 'work' | 'public'
      - `user_id` string
    - `public_keys` PublicKey[]
      - `alg` string
      - `crv` string
      - `date_insert` string, date-time
      - `date_update` string, date-time
      - `emails` string[]
      - `expire_date` string, date-time
      - `fingerprint` string
      - `kty` string
      - `key_id` string, required
      - `type` string
      - `resource_id` string, required
      - `resource_type` string
      - `size` integer
      - `use` string
      - `user_id` string, required
      - `x` integer
      - `y` integer
      - `key` string, required — DER or PEM key, base64 encoded
      - `label` string, required

---

[API](https://skmtc.net/caliopen/apis/caliopen-http-rest-api.md) · [All operations](https://skmtc.net/caliopen/apis/caliopen-http-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/caliopen/caliopen-http-rest-api/revisions/f32b5d08284d/schema)