Get Web Push Subscription Status - Pacifica

POST /api/v1/account/notifications/web_push/subscription/status

This endpoint returns the state of one browser’s push subscription on your account. Call it when the page loads to find out if you must subscribe again.

Operation Type (for Signing)

Header Field	Type	Content
`"type"`	string	`"get_web_push_subscription"`

Request Body

Field	Type	Need	Description	Example
`”account”`	string	required	User’s wallet address	`42trU9A5…`
`“signature”`	string	required	Cryptographic signature	`5j1Vy9Uq…`
`“timestamp”`	integer	required	Current timestamp in milliseconds	`1716200000000`
`”installation_id”`	string	required	The browser’s installation ID from Register Web Push subscription	`k3Jx9_Qm…`
`“expiry_window”`	integer	optional	Signature expiry in milliseconds	`30000`
`”agent_wallet”`	string	optional	Agent wallet address	`69trU9A5…`

{
  "account": "42trU9A5...",
  "signature": "5j1Vy9Uq...",
  "timestamp": 1716200000000,
  "installation_id": "k3Jx9_Qm2LpV7nRt4WcY8bZa1HdF6sGe",
  "expiry_window": 30000
}

You can sign this request with the account key or with an agent wallet.

Response

Status 200: Successfully retrieved the subscription state

{
  "success": true,
  "data": {
    "subscription_id": "3f1c2a7e-9b4d-4e8a-8c2f-6d5b1a0e9f47",
    "state": "active",
    "vapid_public_key": "BF6x0Kq2..."
  },
  "error": null,
  "code": null
}

Field	Type	Description
`”subscription_id”`	UUID or null	Subscription ID. `null` when `“state”` is `“not_registered"`
`"state”`	string	Subscription state (see below)
`“vapid_public_key”`	string or null	VAPID public key that the subscription was registered with. `null` when `“state”` is `“not_registered”`

Subscription States

`state`	Meaning	What to do
`active`	Pacifica sends Web Push to this browser	Nothing
`not_registered`	This installation has no subscription on this account	Register if the user wants Web Push
`disabled`	The subscription was unregistered, replaced by a newer one over the limit, or reported gone by the push service	Subscribe again only if the user asks
`expired`	The subscription’s expiration time has passed	Subscribe again and register
`key_rotated`	The subscription uses an older VAPID key	Subscribe again with the current key and register

Status 400: Invalid request parameters or signature. A bad installation_id returns error_id invalid_notification_device_id
Status 403: The account doesn’t exist. An account exists after its first deposit
Status 409: Web Push isn’t available (web_push_disabled)
Status 429: Rate limit exceeded
Status 500: Internal server error

Code Example (Python)

import requests

payload = {
    "account": "42trU9A5...",
    "signature": "5j1Vy9Uq...",
    "timestamp": 1716200000000,
    "installation_id": "k3Jx9_Qm2LpV7nRt4WcY8bZa1HdF6sGe"
}

response = requests.post(
    "/api/v1/account/notifications/web_push/subscription/status",
    json=payload,
    headers={"Content-Type": "application/json"}
)

data = response.json()