List Countries - VirtualSMS Docs

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"
    }
  ]
}

GET

api

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"
    }
  ]
}

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[]

List Services Price Lookup