List push devices
curl --request GET \
--url https://api.sendrealm.com/push/devices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sendrealm.com/push/devices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sendrealm.com/push/devices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"status": 123,
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"device_id": "<string>",
"app_id": "<string>",
"app_name": "<string>",
"platform": "<string>",
"environment": "<string>",
"external_id": "<string>",
"app_version": "<string>",
"sdk_version": "<string>",
"os_version": "<string>",
"device_model": "<string>",
"locale": "<string>",
"region": "<string>",
"permission_status": "<string>",
"subscribed": true,
"registration_token_present": true,
"apns_environment": "<string>",
"last_registration_at": "2023-11-07T05:31:56Z",
"last_active_at": "2023-11-07T05:31:56Z",
"last_provider_error": {
"code": "<string>",
"message": "<string>",
"occurred_at": "2023-11-07T05:31:56Z"
},
"contact": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "jsmith@example.com"
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"metadata": {
"total": 123,
"items": 123,
"limit": 123,
"after": "<string>",
"next": "<string>",
"has_more": true
}
}{
"status": 123,
"error": {
"code": "<string>",
"message": "<string>",
"details": "<string>",
"issues": [
{
"code": "<string>",
"path": "<string>",
"message": "<string>"
}
]
}
}Push Notifications
Push Devices
Find registered devices and inspect app-side integration state.
GET
/
push
/
devices
List push devices
curl --request GET \
--url https://api.sendrealm.com/push/devices \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sendrealm.com/push/devices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sendrealm.com/push/devices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"status": 123,
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"device_id": "<string>",
"app_id": "<string>",
"app_name": "<string>",
"platform": "<string>",
"environment": "<string>",
"external_id": "<string>",
"app_version": "<string>",
"sdk_version": "<string>",
"os_version": "<string>",
"device_model": "<string>",
"locale": "<string>",
"region": "<string>",
"permission_status": "<string>",
"subscribed": true,
"registration_token_present": true,
"apns_environment": "<string>",
"last_registration_at": "2023-11-07T05:31:56Z",
"last_active_at": "2023-11-07T05:31:56Z",
"last_provider_error": {
"code": "<string>",
"message": "<string>",
"occurred_at": "2023-11-07T05:31:56Z"
},
"contact": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "jsmith@example.com"
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"metadata": {
"total": 123,
"items": 123,
"limit": 123,
"after": "<string>",
"next": "<string>",
"has_more": true
}
}{
"status": 123,
"error": {
"code": "<string>",
"message": "<string>",
"details": "<string>",
"issues": [
{
"code": "<string>",
"path": "<string>",
"message": "<string>"
}
]
}
}Endpoints
GET /push/devicesGET /push/devices/:id
app_id, platform, environment, subscription state, or a
device/external ID search. Responses include permission state, SDK/app/OS
versions, registration presence, recent activity, contact linkage, and the
latest provider error without exposing APNs, FCM, or Web Push credentials.
Device initialization, provider registration, permission changes, login, tags,
and client events continue to use the app-facing Push API through the device
SDKs. These API-key routes are diagnostic and read-only.Authorizations
Integration key for backend workloads, or a scoped personal key (sr_user_) for account discovery and supported project operations. MCP accepts only personal keys.
Headers
Explicit project context. Required for personal-key project resource calls; integration keys retain their configured default. MCP clients supply project_id in each tool call instead.
Query Parameters
Maximum number of records to return. Defaults to 20.
Required range:
1 <= x <= 100Opaque cursor from the previous page's metadata.next value.
Available options:
android, ios, web Available options:
production, development