---
title: "List available countries"
method: GET
path: "/api/v1/customer/countries"
tags: ["Customer API"]
---

# List available countries

`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`

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.

## Query parameters

- `service` string
- `include_voip` boolean

## Response `200`

List of countries

- object
  - `success` boolean
  - `countries` object[]

## Other responses

- `401`: Invalid or missing API key

---

[API](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and.md) · [All operations](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/llms.txt) · [OpenAPI document](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/revisions/be89af981be1?raw)