Quick links

Long-term SMS
Balance
My Account
Important articles

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
8activating
7processing
6refunded
5cancelled
4resend
3completed
2expired
1pending

How to use the SMSPool API

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.

Return to knowledgebase

About the author

Other 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
Notifications
New notifications - Mark all as read
Preferences
Color mode
Look
Audio mode
Prompts