# GET /v2/devices

**List devices**

Every device registered on the account, newest `lastSeen` first. Use the `device_id` values here as `channel_config.device_id` when subscribing a `mobile_push` webhook.

## Plan access

- **Plan access.** Included on every plan — but a device only receives anything once a `mobile_push` webhook targets it, and webhooks are paid (Hobby and above).
- **Rate limit.** Hobby 600/min · Pro 6,000/min · Scale 60,000/min.

## Status codes

- **200** — Envelope with `devices` — array of device records.

## Sample response

```json
{
  "as_of": "2026-07-27T14:26:02.000Z",
  "devices": [
    { "device_id": "dev_aB3xY9kQpLmZ", "deviceName": "iPhone 17", "platform": "ios", "createdAt": 1785161140, "lastSeen": 1785161140 }
  ]
}
```

## Examples

### List

Request:

```shell
curl "https://api.tickerbot.io/v2/devices" \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-07-27T14:26:02.000Z",
  "devices": [
    { "device_id": "dev_aB3xY9kQpLmZ", "deviceName": "iPhone 17", "platform": "ios", "createdAt": 1785161140, "lastSeen": 1785161140 }
  ]
}
```

---

Interactive sandbox + parameter editor: https://tickerbot.io/docs/endpoints/devices/list