Customer API

List available countries

Returns countries where numbers are available.

  • Without service filter: Returns all countries with available numbers, including which services are available per country.
  • With service filter: Returns countries for that specific service with exact pricing.

By default, only physical SIM card numbers are included. Add include_voip=true for VoIP numbers.

get/api/v1/customer/countries

Request

  • Base URL: https://virtualsms.io
  • URL: https://virtualsms.io/api/v1/customer/countries
  • Auth: API key in header X-API-Key

Query parameters

servicestring

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

include_voipboolean

Include VoIP numbers (default false - physical SIM only)

Response

List of countries

successboolean
countriesobject[]

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.