Quick links
Your API key
You can find your API key in your settings page
| ID | Service Name |
|---|---|
|
Loading...
Loading services...
|
|
| ID | Country Name | Code |
|---|---|---|
|
Loading...
Loading countries...
|
||
| ID | Country Name | Region | Rental Terms (Days) |
|---|---|---|---|
|
Loading...
Loading rental countries...
|
|||
| ID | Pool Name |
|---|---|
|
Loading...
Loading pools...
|
|
Order status codes returned by the API.
| Code | Status |
|---|---|
| 8 | activating |
| 7 | processing |
| 6 | refunded |
| 5 | cancelled |
| 4 | resend |
| 3 | completed |
| 2 | expired |
| 1 | pending |
How to use the SMSPool API
- By SMSPool Admin
- SMSPool
What is the SMSPool API?
The SMSPool API lets your own software do everything you can do on our website: order SMS verifications, manage rentals and eSIMs, check your balance and more. Connect it to your scripts, bots or applications to automate your workflow.
How do I use the SMSPool API?
All endpoints live under https://api.smspool.net/, and using the API is free; you only pay for what you order. Every request returns JSON, and parameters can be sent as a GET query or as POST form fields unless an endpoint says otherwise.
Authenticate with your API key, which you can find on your settings page. Send it as a bearer token (Authorization: Bearer YOUR_API_KEY) or as a key parameter. Your API key gives full access to your orders and balance, so never share it.
Where can I find the documentation?
The full API reference is at https://api.smspool.net/docs. It lists every endpoint with its parameters and example responses, and lets you send test requests from your browser.
Prefer a ready-made client? We have official SDKs for Python, JavaScript, PHP, Go, .NET, Java and Ruby.
What can I do with the API?
- Order SMS verifications for hundreds of services and countries
- Rent numbers for longer periods and read their messages
- Buy and manage data-only eSIMs
- Run carrier lookups on phone numbers
- Check your balance, active orders and order history
Are there rate limits?
For standard accounts, each endpoint allows up to 600 requests per minute. A few have lower limits: /sms/check and /sms/stock allow 200 per minute, and /sms/cancel allows 150. Requests made without an API key are limited by IP address, to 20 per minute on /sms/check, /sms/stock, /request/pricing and /service/retrieve_all.
These endpoints have no rate limit: /request/active, /request/balance, /request/orders, /preorder/all, /rental/retrieve_messages and /rental/retrieve_status. To follow your orders, poll /request/active, which returns all of them at once, instead of calling /sms/check for each one.
If you go over a limit, the API answers with HTTP status 429; wait a moment and try again.
Failed orders, such as ordering a service that is out of stock, have their own limit. After 150 failed orders within 5 minutes, ordering is paused for 5 minutes. If your overall success rate drops below 10%, ordering is paused for up to 6 hours.
Business accounts have no API rate limits and no failed-order pauses. Read more about business accounts.
Do you support the SMS-Activate / Hero-SMS API?
Yes. Point your existing SMS-Activate or Hero-SMS client at https://api.smspool.net/stubs/handler_api and use your SMSPool API key as api_key.
Supported actions: getPrices, getBalance, getNumber, getStatus and setStatus. Supported parameters: action, service, country, maxPrice, pool (or operator) and id.
By default, services and countries use SMS-Activate / Hero-SMS IDs. To use SMSPool's IDs instead, add setting=smspool to the URL's query string.
About the author
SMSPool Admin
The owner of SMSPool.net, a site that originally started as a hobby but saw rapid expansion due to the high demand, loves anything technology related and loves writing about technology related articles.
www.smspool.netOther interesting articles
Getting Started with SMSPool
New to SMSPool? Set up your account, order your first number, and get an SMS verification in minutes. The complete beginner's guide.
- By Admin
- June 18, 2026
How to get a Facebook SMS verification
In this guide we will show you a step to step guide on registering on Facebook without a phone number, using a Facebook SMS verification service.
- By Admin
- May 24, 2023
Perplexity AI Phone Number Verification
Perplexity AI requires a real phone number to verify your account and VoIP numbers won't work. Get a non-VoIP number instantly with SMSPool and get back in.
- By Admin
- May 7, 2026
Windows 10 has reached the end of Support
This article explains which options you have now that Windows 10 Support has ended as of 14th October 2025.
- By Admin
- October 23, 2025
How to get a Twilio SMS verification
This guide shows you how to sign up for a Twilio account with our Twilio SMS verification service.
- By Admin
- April 15, 2024
How to Get Uber Phone Verification
Enhance your Uber account security with insights on Uber phone verification and the advantages of temporary virtual phone numbers.
- By Admin
- February 3, 2024
How to Get a Singapore Phone Number
Get a Singapore phone number using the SMSPool service.
- By Admin
- June 7, 2024