# List your devices

`GET https://api.cryptohopper.com/v1/device/list`

Part of [Devices](https://www.cryptohopper.com/api-documentation/api-reference/devices.md) in the Cryptohopper API reference.

Returns all devices registered on your account with their platform, location, IP address, state and activity times. The calling device must itself be authorized.

The handler checks no OAuth scope. state is 0 (not authorized), 1 (authorizing) or 2 (authorized). Times are Unix timestamps; 0 means not set.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/device/list" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "id": 1237001,
            "name": "Chrome 128 (Windows 10.0.0)",
            "location": "Amsterdam, NL",
            "ipAddress": "203.0.113.10",
            "platform": "WEB",
            "state": 2,
            "deviceId": "3f9c2a7e-51b4-4c1d-9a0e-7b6d2f1c8e44",
            "lastActivity": 1790316000,
            "createdAt": 1786000000,
            "deletedAt": 0,
            "expiration": 1791184000,
            "revokedAt": 0,
            "sessionId": "api://device/authorize"
        }
    ]
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.