Mobile Notification API Documentation

Почати

Your first request in four steps

List your connected mobiles and copy the target SID.

Create a notification with a title and message.

Poll the list endpoint by SID.

Use distribued_status and GMT timestamps to track distribution.

The secure SMSMobileAPI mobile app connecting a phone to the web dashboard and REST API for SMS and call operations — Encrypted mobile-to-platform connection

Official mobile application

The secure bridge between your phone, dashboard and API.

SMS and call operations pass through the official SMSMobileAPI app installed on your connected phone. The app securely pairs the device with your account, synchronizes authorized events and links the mobile network to the dashboard and REST API.

1Mobile appPairs the phone and its SIM 2Encrypted linkAuthenticates and protects data in transit 3Dashboard & APIControls workflows and activity

Signed releases distributed through the official Google Play and Apple App Store listings
Google and Apple platform review, signing and distribution controls
Secure device pairing, HTTPS transport and authenticated API access
Only the permissions required for the mobile features you enable

Get the official SMSMobileAPI app on Google Play

Download the official SMSMobileAPI app on the Apple App Store

Capabilities depend on the permissions and background access allowed by Android or iOS.

Аутентифікація

Keep credentials on your server

Notification endpoints use the apikey parameter. A target phone is identified by sid when sending and by sid or sidentifiant when listing.

POST · GET

Send a notification

ENDPOINThttps://api.smsmobileapi.com/notification/send

Creates an internal notification for one connected device.

When to use it

Use it for operational alerts that should appear on a managed phone.

Параметри

Ім'я	Тип	Requirement	опис
`apikey`	рядок	Обов'язковий	Ваш ключ API.
`sid`	рядок	Обов'язковий	Target mobile SID.
`title`	рядок	Необов'язково	Notification title; defaults to Notification.
`message`	рядок	Обов'язковий	Notification content.
`type`	рядок	Необов'язково	Notification type; defaults to notification.

Request example

cURL

curl -X POST "https://api.smsmobileapi.com/notification/send" \
  -d "apikey=YOUR_API_KEY" \
  -d "sid=TARGET_SIDENTIFIANT" \
  --data-urlencode "title=Order ready" \
  --data-urlencode "message=Order #1042 is ready for collection."

Приклад відповіді

JSON

{
  "success": true,
  "message": "Notification created.",
  "id": 22087,
  "apikey": "YOUR_API_KEY",
  "sid": "508b004b4aadacc4"
}

Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.

Connect key ↑

Good to know

Creation and distribution are separate events. Use the list endpoint to verify delivery to the device.

ОТРИМАТИ

List notifications

ENDPOINThttps://api.smsmobileapi.com/notification/list/

Returns up to 200 notifications ordered from newest to oldest.

When to use it

Use it to monitor distribution and build a notification history.

Параметри

Ім'я	Тип	Requirement	опис
`apikey`	рядок	Обов'язковий	Ваш ключ API.
`sidentifiant`	рядок	Необов'язково	Filter by target mobile.
`sid`	рядок	Необов'язково	Alias of sidentifiant.
`distribued`	0 \| 1	Необов'язково	1 for distributed, 0 for not distributed.
`date_from`	РРРР-ММ-ДД	Необов'язково	Start date.
`date_to`	РРРР-ММ-ДД	Необов'язково	End date.

Request example

cURL

curl "https://api.smsmobileapi.com/notification/list/?apikey=YOUR_API_KEY&sidentifiant=TARGET_SIDENTIFIANT&distribued=1"

Приклад відповіді

JSON

{
  "success": true,
  "count": 1,
  "data": [{
    "sidentifiant": "508b004b4aadacc4",
    "title": "Order ready",
    "message": "Order #1042 is ready for collection.",
    "distribued": "1",
    "distribued_status": "distributed",
    "distributed_at_gmt": "2026-03-18 10:18:30",
    "distributed_at_unix": 1773829110,
    "sent_at_gmt": "2026-03-18 10:15:03",
    "sent_at_unix": 1773828903
  }]
}

Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.

Connect key ↑

Good to know

All sent and distributed timestamps are GMT.

Усунення несправностей

Errors and safe retries

Read the HTTP status and the JSON error field before retrying. Do not retry validation or authentication failures without correcting the request first.

HTTP	Коди	What to do
400	`Missing required param`	apikey, sid or message is missing.
400	`Invalid date format`	Use YYYY-MM-DD for date_from and date_to.
400	`Invalid distribued value`	Only 0 or 1 is accepted.
500	`DB connection / query failed`	The notification service could not complete the operation.

Retry ruleRetry only transient 429 and 5xx responses. Start after 1 second, then back off to 2, 4 and 8 seconds.

Потрібна допомога?

Bring the request context—not your secrets.

Share the endpoint, timestamp, HTTP status and sanitized response. Never include API keys, tokens or private message content.

Contact API support →

Notification API documentation

Your first request in four steps

The secure bridge between your phone, dashboard and API.

Keep credentials on your server

Параметри

Request example

Приклад відповіді

Параметри

Request example

Приклад відповіді

Errors and safe retries

Bring the request context—not your secrets.