Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

API
Best for
Payment model
Order access

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.com

Fastest path: receive an SMS

  1. Discover service codes with GET /v2/receive-sms/catalog.

  2. Get a live quote with POST /v2/receive-sms/quote.

  3. Create an idempotent order with POST /v2/receive-sms/orders.

  4. Save the returned orderId and accessToken, then pay the invoice.

  5. Poll GET /v2/receive-sms/orders/{orderId} every 5–10 seconds.

  6. Stop when the order reaches a terminal state.

Live discovery

Support

Last updated