---
title: "List push tokens"
method: GET
path: "/v1/push-tokens"
tags: ["Push Tokens"]
---

# List push tokens

`GET /v1/push-tokens`

## Request

- Base URL: `https://api.forwardemail.net`
- URL: `https://api.forwardemail.net/v1/push-tokens`
- Auth: one of:
  - HTTP basic
  - HTTP basic

Retrieve all active (non-expired) push tokens for the authenticated alias. Supports optional platform filtering via query parameter.

## Query parameters

- `platform` 'apns' | 'fcm' | 'unified-push' | 'web-push'
- `alias_id` string

## Response `200`

Push tokens retrieved successfully

- PushToken[]
  - `id` string: Unique push token document ID
  - `alias` string: Alias ID this token belongs to
  - `platform` 'apns' | 'fcm' | 'unified-push' | 'web-push': Push notification platform
  - `token` string: Device token, registration token, or push endpoint URL
  - `device_name` string: Optional human-readable device name
  - `last_used_at` string, date-time, nullable: Last successful push delivery timestamp
  - `failure_count` integer: Consecutive delivery failure count (auto-pruned at 3)
  - `expires_at` string, date-time: Token expiry (auto-extended on successful delivery)
  - `created_at` string, date-time: Registration timestamp
  - `updated_at` string, date-time: Last update timestamp
  - `object` 'push_token': Object type identifier

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/forwardemail/apis/forward-email-api.md) · [All operations](https://skmtc.dev/forwardemail/apis/forward-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forwardemail/apis/forward-email-api/revisions/ecefab4527f6?raw)