Devices
View registered devices, filters by country, language, platform and external_id
The Devices section contains a list of all registered devices for your application. Here you can find a specific device for diagnostics, check the audience composition or confirm that the SDK is correctly registering new devices.
How Devices Enter the System
Devices register automatically via SDK on the first application launch. After successful SDK initialization:
- The device receives a unique
install_token(ic). - A record is created on the server with the platform, country, language, timezone and transport token.
- On each subsequent launch, the SDK updates the data (token, geolocation, language).
Devices cannot be manually added through the dashboard.
If you are integrating Notify Partners without SDK (server-to-server), you can use server-side registration via API: POST /api/v3/apps/:app_id/devices.
Filters
Use filters to find the required devices:
| Filter | Description |
|---|---|
| Application | Select one or more applications |
| Country | Filter by ISO country code (RU, US, DE, ...) |
| Language | Device language (ru, en, es, ...) |
| Platform | android / ios / web |
| Audience Groups | Find devices in specific segments |
| Events | Find devices with specific events (dep, reg, ...) |
| External ID | Find a device by your internal user ID |
Filters can be combined. Results are paginated.
Data per Device
For each found device the table displays:
| Field | Description |
|---|---|
| External ID | Your internal user ID (from SDK) |
| Platform | android / ios / web |
| Country | Country by IP or device data |
| Language | Device system language |
| Model | Device model or browser (e.g., Pixel 8 Pro, Chrome 120) |
| Timezone | Time zone (UTC+3) |
| Transport Token | FCM token, APNs token or Web Push subscription |
| Registration Date | When the device first registered |
| Last Activity | When the SDK last updated device data |
Troubleshooting
If push notifications are not reaching a specific user:
- Find the device by the user's
external_id. - Check for a transport token — if the field is empty, the SDK did not send a token.
- Check the last activity date — if it was long ago, the application may have been deleted.
- Make sure the device's country and language are not excluded by scheduler filters.
Server-Side Device Registration
For integrations without SDK (e.g., server-side postback registration), the API is available:
POST /api/v3/apps/:app_id/devices
PUT /api/v3/apps/:app_id/devices/:external_idIn this case, install_token is automatically formed as srv_ + external_id.
More about API integration — in the API Keys section and API documentation.
Querying Devices via API
POST /api/v3/query/app-instancesThe request supports the same filters as the dashboard: country, language, platform, audience groups, events, external_id. Useful for integrations that need to know the current audience composition.