Get your first SMS in 90 seconds
REST API, 4 typed SDKs, signed webhooks, idempotency keys, single-tenant pools on Enterprise. Full reference + working code in your language.
Three calls and you're done
- 1Buy a number
Pick country + service. We assign a real phone number from the cheapest healthy upstream pool.
curl -X POST https://api.eveses.com/api/v1/numbers/orders \ -H "Authorization: Bearer $KEY" \ -d '{"country":"ua","mode":"activation","service":"telegram"}' # → 201 Created · 142ms # { "order_id":"ord_91f3a2b8", "phone":"+380635551822", "status":"waiting", "price_cents":7 } - 2Wait for SMS · poll or webhook
Either subscribe to
activation.sms_receivedwebhook or poll. p95 SMS arrival is 2.1 seconds.curl https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/sms \ -H "Authorization: Bearer $KEY" # → 200 OK · 87ms # { "status":"sms_received", "sms":[{ "otp":"123456", "received_at":"..." }] } - 3Finish — funds get charged
Until you call finish, funds stay held, not spent. Cancel any time within the window for a full refund.
curl -X POST https://api.eveses.com/api/v1/numbers/orders/ord_91f3a2b8/finish \ -H "Authorization: Bearer $KEY" # → 200 OK · 61ms # { "status":"finished", "charged_cents":7 }
Browse the docs
Searchable, with examples in 4 languages, and live Try-it sandbox in every endpoint.
Your first SMS verification in under 90 seconds — sign up, create an API key, get a code.
Per-SMS verifications — the lifecycle of a single one-time code from request to billing.
How to authenticate API requests with bearer tokens.
Hold a number for hours or days — receive multiple SMS, browse history, auto-renew at expiry.
Receive activations, rentals, and wallet events as HTTPS callbacks with HMAC signing.
Balance, top-ups, holds, refunds and auto-recharge — how money moves through your Eveses account.
Bearer tokens, key rotation, IP allowlists, and the errors you'll see when auth goes wrong.
Official client libraries: PHP, JavaScript, Python, Go — install, configure, and the call sites that matter.
How the `Idempotency-Key` header keeps retries from double-charging on flaky networks.
Live OpenAPI spec, Scalar viewer, Postman collection — generate clients, mock servers, anything else.
📦 Typed SDKs
4 languages · all generated from the same OpenAPI spec · auto-retried · typed errors.
Ready to ship?
First activation on us · no card required · refund if no SMS.
⚡ Sign up — start buildingNew geos, new pools, new endpoints.
We add countries, rotate pools and ship API changes most weeks. Drop your email and we'll send the ones worth knowing about — new geo coverage, price-ladder changes and anything that breaks an integration.
Unsubscribe with one click. We never share your email.