check exist push token device

Check Exist Push Token Device

This endpoint verifies whether a push notification token already exists for a specified device. It is used to determine if a device has been registered to receive push notifications before attempting to register or update it. The response returns a boolean indicating the existence of the token/device combination.

Endpoint

GET /settings/pushExist

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint before registering a new push notification token to avoid duplicate registrations. It is also useful during app re-installs or device migrations to check whether an existing token record needs to be updated or removed. This check helps maintain accurate device-to-token mappings for reliable push notification delivery.

Query Parameters

ParameterTypeRequiredDescription
deviceIdstringNoThe unique identifier of the device to check.
pushTokenstringNoThe push notification token associated with the device.

Response

200 OK

FieldTypeDescription
valuebooleantrue if the push token/device combination exists; false otherwise.
{
  "value": true
}

Error Codes

CodeWhen it happens
400Missing required fields or validation error
401Token missing, expired, or invalid
403Insufficient permissions
404Resource not found
500Internal server error

Common Mistakes

  • Passing a deviceId or pushToken that has not yet been registered will return { "value": false } — this is not an error, it simply means no record exists.
  • Omitting both query parameters will result in an indeterminate lookup; always supply at least one to get a meaningful result.

Related Endpoints

  • POST /settings/pushToken — Register or update a push notification token for a device.
  • DELETE /settings/pushToken — Remove a push notification token for a device.

Example

curl -X GET "https://api.banking.netevia.dev/settings/pushExist?deviceId=device-abc-123&pushToken=fcm-token-xyz-789" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"
Query Params
string
string
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json