DEVELOPER API

Virtual Number API

Provision virtual phone numbers on demand — short-term activations or long-term rentals.

The Virtual Number API provisions programmable phone numbers across 190+ countries for SMS verification. Use short-lived activations for one-time codes, or rent a number for days-to-months when you need a stable line. Everything is REST, wallet-billed, and available through official SDKs.

Como funciona

Pick activation or rental

Activations are per-code and cheap; rentals hold a number for a fixed period for repeat use.

Target a service & country

Numbers can be scoped to a service (better delivery) or general-purpose, in the country you choose.

Consume codes via API

Read inbound codes over REST or webhooks; rotate numbers programmatically at scale.

Exemplos de código

Provision a virtual number and fetch its code.

# 1 — request a number for the service
curl -X POST "https://api.eveses.com/v1/numbers/orders" \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"any-vn","country":"de"}'
# → { "id":"act_9f2", "number":"+1202555••••", "status":"waiting" }

# 2 — poll for the code (or use a webhook)
curl "https://api.eveses.com/v1/numbers/orders/act_9f2" \
  -H "Authorization: Bearer $EVESES_API_KEY"
# → { "id":"act_9f2", "status":"received", "code":"483920" }

Pricing

Activations are per-code; rentals are a flat fee for the period. Both draw from your Eveses wallet with volume discounts.

Todos os preços →

Integrations

ZapierMaken8nPostmanWebhooksRESTOpenAPI

Mande webhooks para Zapier, Make ou n8n — ou chame a API REST direto.

SDKs oficiais

JavaScript / TypeScript ↗Python ↗Go ↗PHP ↗

OpenAPI e Postman

Importe a especificação OpenAPI ou a coleção do Postman para gerar um cliente tipado em qualquer linguagem.

Abrir a especificação →

FAQ

What is a virtual phone number?›

A virtual number is a cloud phone line with no physical SIM. It can receive SMS (and, for some products, calls) and is provisioned and released entirely through the API.

Activation vs. rental — which do I need?›

Use an activation for a single verification (cheapest). Use a rental when you need the same number available over days or weeks for repeated inbound messages.

How many numbers can I provision?›

As many as your wallet balance and the country pool allow — the API is built for high-volume, concurrent provisioning.