# sms4sats API Documentation

## sms4sats API Documentation

- [Introduction](https://docs.sms4sats.com/introduction.md): Build Lightning-powered SMS, number-rental, and email activation workflows with sms4sats API v2.
- [Quickstart](https://docs.sms4sats.com/getting-started/getting-started.md): Create, pay, and poll your first sms4sats API v2 order.
- [Choose an API](https://docs.sms4sats.com/getting-started/api-options.md): Choose the right sms4sats API v2 payment and authentication model.
- [Hold Invoices & Payment Safety](https://docs.sms4sats.com/getting-started/hold-invoices.md): Understand when sms4sats Lightning hold invoices settle or release.
- [Wallets & Payments](https://docs.sms4sats.com/getting-started/wallets.md): Pay sms4sats BOLT11 invoices with a Lightning wallet, Lightning Pay Kit, or a supported swap route.
- [Lightning Node](https://docs.sms4sats.com/getting-started/node-info.md): Connect directly to the sms4sats Lightning node for reliable payment routing.
- [Overview](https://docs.sms4sats.com/api-reference/api-reference.md): Complete endpoint map and conventions for sms4sats API v2.
- [Catalog & Quotes](https://docs.sms4sats.com/api-reference/catalog-and-quotes.md): Discover service codes and request current quotes before creating an order.
- [Create a Bearer-Token Order](https://docs.sms4sats.com/api-reference/create-order.md): Create an idempotent receive-SMS or rental order and receive its hold invoice and access token.
- [Poll an Order](https://docs.sms4sats.com/api-reference/get-order.md): Poll a protected receive-SMS or rental order and read its messages and cancellation state.
- [Cancel an Order](https://docs.sms4sats.com/api-reference/cancel-order.md): Cancel an eligible bearer-token order and safely release its held payment.
- [Rent Numbers](https://docs.sms4sats.com/api-reference/rent-numbers.md): Rent a temporary number for multiple incoming SMS messages.
- [L402 API](https://docs.sms4sats.com/api-reference/l402.md): Integrate sms4sats with L402 payment challenges, macaroons, and Lightning preimages.
- [Email Activations](https://docs.sms4sats.com/api-reference/emails.md): Discover domains, create email activation orders, poll messages, reorder, and cancel safely.
- [Order States](https://docs.sms4sats.com/api-reference/order-states.md): Interpret sms4sats order lifecycle states and know when to stop polling.
- [Errors, Limits & Retries](https://docs.sms4sats.com/api-reference/errors.md): Handle sms4sats API v2 errors, rate limits, authentication failures, and safe retries.
