Skip to main content
GET
/
api
/
v1
/
customer
/
countries
List available countries
curl --request GET \
  --url https://virtualsms.io/api/v1/customer/countries \
  --header 'X-API-Key: <api-key>'
{ "success": true, "countries": [ { "country_id": "ID", "country_name": "Indonesia", "min_price": 0.05, "services": "tg,wa,ig" }, { "country_id": "PH", "country_name": "Philippines", "min_price": 0.1, "services": "tg,wa" } ] }

Documentation Index

Fetch the complete documentation index at: https://virtualsms.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

API key from virtualsms.io dashboard (Settings -> API tab). Prefix: vsms_

Query Parameters

​
service
string

Filter by service code (e.g. tg, wa, ig). Returns per-service pricing when set.

​
include_voip
boolean
default:false

Include VoIP numbers (default false - physical SIM only)

Response

List of countries

​
success
boolean
Example:

true

​
countries
object[]