> ## 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.

# Price Lookup

> Public endpoint for service / country pricing, no authentication required.

## Public, no auth

The price endpoint is the only public endpoint that does not require an API key.

```bash theme={null}
curl "https://virtualsms.io/api/v1/price?service=wa&country=GB"
```

## Query parameters

| Name      | Required | Description                              |
| --------- | -------- | ---------------------------------------- |
| `service` | yes      | Service code (e.g. `wa`, `tg`, `ig`)     |
| `country` | yes      | ISO country code (e.g. `GB`, `US`, `DE`) |

## Response

```json theme={null}
{
  "success": true,
  "service": "wa",
  "country": "GB",
  "price": 0.90,
  "currency": "USD",
  "available": true
}
```

If the combination is not currently in stock:

```json theme={null}
{
  "success": false,
  "service": "tg",
  "country": "US",
  "error": "Service/country combination not available"
}
```

## Use cases

* Display live pricing on a landing page without exposing an API key
* Pre-flight check before calling `/customer/purchase`
* Bulk pricing lookups for multiple country/service combinations

For paid features (balance, purchase, order management), see the authenticated `/customer/*` endpoints.