Authentication

All API requests require an API key.

Get your API key

Go to Settings → API after creating an account.

Pass your key via header (recommended):

curl https://virtualsms.io/api/v1/balance \
  -H "x-api-key: YOUR_API_KEY"

Or via query parameter:

curl "https://virtualsms.io/api/v1/balance?api_key=YOUR_API_KEY"

Never expose your API key in client-side code or public repositories.

Status	Meaning
`401 Unauthorized`	Missing or invalid API key
`403 Forbidden`	Key valid but insufficient permissions
`429 Too Many Requests`	Rate limit exceeded