Introduction
Build Lightning-powered SMS, number-rental, and email activation workflows with sms4sats API v2.
Use sms4sats to receive one-time SMS codes, rent temporary phone numbers, or receive email activation codes. Those products use per-order Bitcoin Lightning payments—no customer account or prepaid balance required. For outgoing messages, see the separate Send SMS section, including legacy-compatible prepaid balances and top-ups.
Prefer a user interface? Open the sms4sats web app.
Choose your integration
Web, mobile, backend apps, and most bots
Lightning hold invoice
Opaque bearer token returned at creation
AI agents and Lightning-native services
BOLT11 invoice + payment preimage
L402 macaroon and preimage
Temporary email activation codes
Lightning hold invoice
Bearer token when the capability header is requested
All APIs use this origin:
https://api.sms4sats.comFastest path: receive an SMS
Discover service codes with
GET /v2/receive-sms/catalog.Get a live quote with
POST /v2/receive-sms/quote.Create an idempotent order with
POST /v2/receive-sms/orders.Save the returned
orderIdandaccessToken, then pay the invoice.Poll
GET /v2/receive-sms/orders/{orderId}every 5–10 seconds.Stop when the order reaches a terminal state.
Live discovery
Support
Last updated