---
title: "Devices registered for notifications"
method: GET
path: "/me/push-devices"
tags: ["Push"]
---

# Devices registered for notifications

`GET /me/push-devices`

## Request

- Base URL: `https://bodylab.lol/api/v1`
- URL: `https://bodylab.lol/api/v1/me/push-devices`
- Auth: HTTP bearer

Never includes the device addresses themselves.

## Headers

- `X-Client-Platform` string
- `X-Client-Version` string

## Response `200`

OK

- object
  - `devices` object[], required
    - `id` string, required: Opaque identifier.
    - `platform` string, required: Which push service reaches this device. Known values: apns, web. Treat unknown values as "other".
    - `label` string, nullable, required
    - `environment` string, nullable, required
    - `createdAt` string, date-time, required: An instant: ISO-8601 with offset, e.g. 2026-09-13T06:30:00Z.
    - `lastSeenAt` string, date-time, required: When this device last registered; clients re-register on launch.
    - `lastSuccessAt` string, date-time, nullable, required: An instant: ISO-8601 with offset, e.g. 2026-09-13T06:30:00Z.
    - `retiredAt` string, date-time, nullable, required: An instant: ISO-8601 with offset, e.g. 2026-09-13T06:30:00Z.
    - `retiredReason` string, nullable, required

## Other responses

- `401`: Error: UNAUTHORIZED.

---

[API](https://skmtc.dev/bodylab/apis/body-lab-api.md) · [All operations](https://skmtc.dev/bodylab/apis/body-lab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bodylab/apis/body-lab-api/revisions/544c201eaf88?raw)