# Activation API

> REST API for automating SMS activations with temporary phone numbers. Supports ordering numbers, receiving SMS, retrying, and canceling. Billing only on received SMS.


## 📝 Overview

Then **Activation API** is designed to automate SMS‑based service activations using temporary mobile numbers. It supports ordering new numbers, retrieving SMS text and OTP codes, retrying, and canceling activations in a sandbox or production environment. Billing applies only when an SMS is successfully received.

**Activation API** is used to integrate SMS activation into applications or services, providing a reliable and cost-effective solution for managing temporary phone numbers and SMS messages.  SMS activation is typically used for account verification, QA, testing, and automation.

---

### 🔑 Key Features

- Request a temporary phone number
- Receive SMS messages and OTP codes sent to that number
- Retry/Cancel activation
- View activation history
- List supported countries
- List eligible services
- Limit maximum price per activation
- Check balance
- Detailed error handling
- Sandbox & production modes
- Billing only on received SMS

---

## 📖 Documentation

- [Activation API Reference (Human-friendly)](https://platfone.com/docs/api/specs/activation-api-doc.html): Readable documentation with examples


- [OpenAPI Specification (YAML)](https://platfone.com/docs/api/specs/activation-api-doc.yaml): Machine-readable spec for code generation and automation



> **Tip**



- See your active and historical activations in [web dashboard](https://platfone.com/app)
.
- Use the **sandbox** environment for testing without incurring costs.