Unregister Expo Device

POST /api/v1/account/notifications/expo/device/unregister

This endpoint turns off an Expo push token for your account. Pacifica stops sending mobile_push notifications to it. Call it when the user signs out of the app.

Operation Type (for Signing)

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

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`
`”expo_push_token”`	string	optional	Expo push token to turn off. Up to 512 characters	`ExponentPushToken[xxxx]`
`“device_id”`	string	optional	Installation key. Turns off the tokens of this installation. Up to 256 characters	`b7f3c1a9…`
`“expiry_window”`	integer	optional	Signature expiry in milliseconds	`30000`
`”agent_wallet”`	string	optional	Agent wallet address	`69trU9A5…`

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

Send expo_push_token or device_id. If you send both, Pacifica uses expo_push_token only. Leave out the field that you don’t send, in the request and in the signed data. Pacifica turns off only tokens of the signing account. An unknown token or device_id doesn’t cause an error. You can sign this request with the account key or with an agent wallet. To get notifications on the device again, call Register Expo device.

Response

Status 200: Token turned off

{
  "success": true,
  "data": null,
  "error": null,
  "code": null
}

Status 400: Invalid request parameters or signature. A token with a bad format returns error_id invalid_expo_push_token. A request without expo_push_token or device_id returns this error:

{
  "success": false,
  "data": null,
  "error": "Either expo_push_token or device_id is required",
  "code": 400,
  "error_id": "unspecified"
}

Status 403: The account doesn’t exist. An account exists after its first deposit
Status 429: Rate limit exceeded
Status 500: Internal server error

Code Example (Python)

import requests

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

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

data = response.json()

​Operation Type (for Signing)

​Request Body

​Response

​Code Example (Python)

Operation Type (for Signing)

Request Body

Response

Code Example (Python)