One API for iMessage (blue bubble) and SMS number rental.
Authenticate every request with your key: header API-KEY: sk_... (or Authorization: Bearer sk_...).
iMessage pricing: 0.15 credits per message sent, 0.05 credits per reply received
in a conversation you started (unsolicited inbound is free). Sends return 402 when your balance can't cover the charge.
POST /v1/messages — send to a new number {to, text, service?, from?} (defaults to iMessage from your first assigned number)
POST /v1/threads/{id}/messages — send in a thread {text}
GET /v1/threads — list conversations
GET /v1/threads/{id}/messages?limit=&before= — paginated history
POST /v1/webhooks {url} — register an inbound webhook (HMAC-signed)
GET /v1/health — device status
GET /sms/services — supported services with current prices in credits
POST /sms/rent {service:"apple"|"google"|"instagram"|"tiktok"} — rent a number (priced per service; the response cost field shows credits charged)
GET /sms/code?transaction_id= — poll for the received code
POST /sms/cancel {transaction_id} — cancel & refund