SMS OTP Verify API Documentation

Use the sim100 REST API to automate SMS verification: order virtual numbers, retrieve OTP codes, check account balance, and view country rates. Integrate with bots, scripts, or backend services in any language that supports HTTP requests.

All endpoints use GET requests and return plain text or simple responses. Replace apikey in the examples below with your customer API key from your account dashboard.

Get your API key:Create a free account or log in. Your API key is your customer ID, available in your dashboard after registration.

API base URL

https://sim100.com/api/user/

Endpoints overview

ActionEndpointMain parameters
Get numberget_number.phpcustomer, app, country
Get SMS / OTPget_sms.phpcustomer, number, country, app
Check balanceget_balance.phpcustomer
Get ratesget_rates.phpcustomer, country
Order historyget_history.phpcustomer

Get Number

Request a virtual phone number for a specific app and country.

https://sim100.com/api/user/get_number.php?customer=apikey&app=appname&country=countryname

Example:

https://sim100.com/api/user/get_number.php?customer=apikey&app=Whatsapp&country=USA

Error messages: Customer Not Found · App Not Found · Country Not Found · New Numbers registration in progress, please wait or check back later · Error 102, check back later.

Rate limit: 5 numbers per minute.

Get SMS (OTP code)

Retrieve the verification SMS for a number you ordered.

https://sim100.com/api/user/get_sms.php?customer=apikey&number=number&country=countryname&app=appname

Example:

https://sim100.com/api/user/get_sms.php?customer=apikey&number=112869xxx&country=malaysia&app=google

Error messages: Customer Not Found · Number Not Found · You have not received any code yet · Your balance is expired · Error 102, check back later.

Time limit: 3 minutes per number.

Check Balance

https://sim100.com/api/user/get_balance.php?customer=apikey

Get Rates

https://sim100.com/api/user/get_rates.php?customer=apikey&country=countryname

Get History

https://sim100.com/api/user/get_history.php?customer=apikey

Support

Need help integrating the API? Visit our FAQs or contact support.

Telegram