DEVELOPER API

OTP API

Programmatic one-time passwords over SMS — request a number, receive the code, verify in seconds.

Obtenir une clé d'APILire la documentation

The Eveses OTP API gives your backend a disposable phone number on demand and streams back the one-time password the moment it lands. No SIM farm, no manual copy-paste — a single POST creates the activation, and a webhook (or long-poll) delivers the code. You are billed only when a code arrives.

Comment ça marche

1

Create an activation

POST a `service` and `country`; you get a live number and an activation id back instantly.

2

Receive the OTP

Subscribe a webhook or long-poll the activation — the parsed numeric code is returned as soon as the SMS is delivered.

3

Only pay on success

If no message ever arrives the activation expires free of charge; you are charged solely for delivered codes.

Exemples de code

Create an activation and read the OTP — cURL, Node, Python, PHP, Go.

# 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-otp","country":"us"}'
# → { "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

Pay-as-you-go per delivered code from your wallet — volume tiers lower the rate automatically. Failed activations are free.

Tous les tarifs →

Integrations

ZapierMaken8nPostmanWebhooksRESTOpenAPI

Envoyez des webhooks vers Zapier, Make ou n8n, ou appelez directement l'API REST.

SDK officiels

JavaScript / TypeScript ↗Python ↗Go ↗PHP ↗

OpenAPI et Postman

Importez la spécification OpenAPI ou la collection Postman pour générer un client typé dans n'importe quel langage.

Ouvrir la spécification →

FAQ

What is an OTP API?›
An OTP (one-time password) API programmatically provisions a phone number and returns the verification code sent to it, so your service can complete SMS-based sign-ups and logins without human involvement.
How fast are codes delivered?›
Most codes arrive within a few seconds. Use a webhook for push delivery, or the wait_for_code helper which long-polls until the code lands or the activation times out.
Do I pay for failed verifications?›
No. An activation that never receives a message expires at no cost — you are billed only for successfully delivered OTPs.
Which services are supported?›
Hundreds — Telegram, WhatsApp, Google, and most apps that verify by SMS. Pass a specific service code, or "any" for a general-purpose number. Service identifiers are internal API identifiers used solely to identify supported services; third-party names are the property of their respective owners.

Guides associés

How does OTP work? HOTP vs TOTP vs SMS one-time passwordsA developer’s guide to one-time passwords — how HOTP, TOTP and SMS OTP are generated and verified, their trade-offs, and when to use each.OTP delivery: webhooks vs pollingPolling is easy to start with; webhooks are how you scale. How to choose, and how to set up a webhook for incoming codes.Handling OTP errors and rate limitsBuild resilient verification: timeouts, refunds for missed codes, retry/backoff, and respecting rate limits.

API associées

SMS Verification APIDrop-in SMS verification for sign-ups and logins — one API call, code back in seconds.Phone Verification APIVerify phone ownership at scale — provision, deliver, confirm, with success-based billing.Receive SMS APISpin up a real phone number and read its inbound SMS over a clean REST API.

Mettez OTP API en production aujourd'hui

Créez un compte, récupérez une clé d'API et lancez votre premier appel en quelques minutes.

Obtenir une clé d'API