# API Documentation

> API documentation for integrating SMS activation services. Includes Activation API, Retail API, and Alternative API with comparison guides.

- [API Overview](https://platfone.com/docs/api/overview.md): Guide for choosing between the Activation API, Retail API, and Alternative API, including capabilities, tradeoffs, and recommended use cases.
- [Activation API](https://platfone.com/docs/api/activation.md): REST API for automating SMS activations with temporary phone numbers. Supports ordering numbers, receiving SMS, retrying, and canceling. Billing only on received SMS.
- [Retail API](https://platfone.com/docs/api/retail.md): Customer-centric API for building SMS activation products with customer balances, transactions, activation management, and reseller-style workflows.
- [Alternative API](https://platfone.com/docs/api/alternative.md): Legacy-compatible SMS activation API for teams migrating from other providers with minimal code changes and familiar GET or POST patterns.
- [Rate Limits](https://platfone.com/docs/api/rate-limits.md): Explains the main API rate limits, including minimum success rate, maximum active activations, endpoint request limits, and 429 block behavior.
- [Sandbox Environment](https://platfone.com/docs/api/sandbox.md): How to use the Platfone sandbox environment to test activations, fake funds, and fake SMS delivery without impacting production data.

## Webhooks

> Section for webhook documentation, including delivery behavior, payload structure, retry logic, and supported event types.

- [Webhooks Overview](https://platfone.com/docs/api/webhooks/webhooks.md): Overview of webhook behavior, delivery flow, retries, configuration in the dashboard, and the common request payload structure.
- [Webhook Events](https://platfone.com/docs/api/webhooks/webhook-events.md): Reference list of webhook event types emitted by the Activation API, Retail API, and Alternative API.