Introduction
Welcome to the BloomSMS Developer API. Our high-performance REST API allows you to automate SMS verifications directly within your software. Whether you are building a bulk account creator, a bot, or a custom verification service, our API provides the speed and reliability you need.
Base URL
https://api.bloomsms.com/stubs/handler_api.phpAuthentication
All requests require your unique API Key. You can find this key in your dashboard under the "API Settings" tab. Pass this key as the api_key parameter in every GET or POST request.
https://api.bloomsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getBalanceGet Balance
Retrieve your current account balance in USD. Use this to ensure you have sufficient funds before requesting a number.
action=getBalance&api_key=YOUR_API_KEYACCESS_BALANCE:14.50BAD_KEYOrder Number
Request a temporary virtual number for a specific service. You must specify the service code and country.
| Parameter | Type | Required | Description |
|---|---|---|---|
| service | string | Yes | Service code (e.g., wa for WhatsApp, tg for Telegram) |
| country | integer | Optional | Country ID (Default: 0 for USA). See Country List. |
action=getNumber&api_key=YOUR_KEY&service=wa&country=0ACCESS_NUMBER:12345678:12025550192NO_NUMBERSGet SMS Code
Poll this endpoint to check the status of an active order. Once the SMS is received, it will be returned here.
action=getStatus&api_key=YOUR_KEY&id=12345678STATUS_WAIT_CODESTATUS_OK:492105Set Status / Cancel
Update the status of an active activation. Use this to cancel a number if no code arrived (refund) or to mark it as finished.
8) within 2 minutes if the code is not received to avoid being charged.| Status Value | Action |
|---|---|
| 1 | SMS Received & Verified (Finish Order) |
| 8 | Cancel Order (Refund) |
action=setStatus&api_key=YOUR_KEY&id=12345678&status=8ACCESS_CANCEL