Endpoint

GET https://sms.phones.inc/v1/health

Overview

Check whether the messaging backend that delivers your iMessages is currently online. Use this before time-sensitive sends — messages queued while the backend is offline are delivered once it reconnects.

Response

ok
boolean
true on success (the API itself is up).
device_online
boolean
Whether the messaging backend is online and processing sends right now.
device_id
string
Identifier of the messaging backend. Only present when the backend has been seen.
last_seen_unix_ms
number
When the backend last checked in, in milliseconds since the Unix epoch. Only present when the backend has been seen.
curl https://sms.phones.inc/v1/health \
  -H "API-KEY: sk_your_api_key"
{
  "ok": true,
  "device_online": true,
  "last_seen_unix_ms": 1765432100000,
  "device_id": "iphone"
}