---
title: "Register Device"
method: POST
path: "/api/notifications/devices"
tags: ["notifications"]
---

# Register Device

`POST /api/notifications/devices`

## Request

- Base URL: `https://api.retirementlab.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.retirementlab.app/api/notifications/devices`
- Auth: HTTP bearer

## Request body

- PushDeviceRegisterRequest
  - `token` string, required
  - `platform` 'ios' | 'android', required
  - `app_version` string
  - `device_model` string

## Response `201`

Successful Response

- PushDeviceResponse
  - `id` integer, required
  - `platform` 'ios' | 'android', required
  - `app_version` string
  - `device_model` string
  - `last_registered_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/retirementlab/apis/income-simulator-api.md) · [All operations](https://skmtc.dev/retirementlab/apis/income-simulator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retirementlab/apis/income-simulator-api/revisions/b0f00a0333fd?raw)
