Push Tokens

List push tokens

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

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

Query parameters

platform'apns' | 'fcm' | 'unified-push' | 'web-push'

Filter tokens by platform

alias_idstring

Required when using API token authentication

Response

Push tokens retrieved successfully

idstring

Unique push token document ID

aliasstring

Alias ID this token belongs to

platform'apns' | 'fcm' | 'unified-push' | 'web-push'

Push notification platform

tokenstring

Device token, registration token, or push endpoint URL

device_namestring

Optional human-readable device name

last_used_atstring date-time nullable

Last successful push delivery timestamp

failure_countinteger

Consecutive delivery failure count (auto-pruned at 3)

expires_atstring date-time

Token expiry (auto-extended on successful delivery)

created_atstring date-time

Registration timestamp

updated_atstring date-time

Last update timestamp

object'push_token'

Object type identifier

Changes

No recorded changes to this operation across all 1 revision of this API.