How it works
Two calls, and you never store a code
You ask for a code, and later send us what the person typed. Everything in between happens on our side.
Ask for a code
Send the phone number or the email address. We make the code and pick the channel: Telegram if the number has it, SMS if not, email for an address.
Fall back by itself
If the Telegram code is not delivered in time, the same code follows by SMS, so nobody waits at your sign up screen.
Check the answer
Send what the person typed and get a plain yes or no. Codes work once, expire, and stop after too many wrong tries.
The API
Send it, then check it
- A phone number or an email address is all a code needs. The answer says which channel carried it.
- You can check by number, address or ID, so there's nothing to keep between the two calls.
- Everything else is optional: the channels, your own code, its expiry, the SMS text and sender, and a reference of your own.
// Send: only the number is required
{ "to": "+447700900142" }
// The answer
{
"id": "7c1e0b52-9d2f-7a41-8e33-52d0f1c7ab90",
"to": "+447700900142",
"status": "sent",
"channel": "telegram",
"channels": ["telegram", "sms"],
"checks_left": 5,
"expires_at": "2026-11-02T09:25:02Z"
}
// Check: POST /v1/verifications/check
{ "to": "+447700900142", "code": "482913" }
// The answer
{ "valid": true, "result": "valid" }
// Or send it by email, and check by address
{ "email": "olivia@example.com", "channels": ["email"] }
What you pay
Pay for the channel that carried the code
A Telegram code that is not delivered is refunded, so a code that falls back to SMS costs the SMS alone. A code by email costs 0.0020 EUR to any address. As with everything else here, there's no monthly fee or minimum.
- By default a code tries Telegram first, and SMS takes over when the number isn't on Telegram or the code hasn't arrived in time.
- Each request can set its own order of channels, or use one channel only.
- You can try it in the web app first: send a code to your own phone or inbox and check it before you start on the integration.
Details
What you set, and what you can see
Your code or ours
Let us make a code of the length you want, or send your own. Choose how long each one stays valid.
Your sender and text
SMS codes go from your approved sender ID in your own words, in any language. Keep the wording in templates and send by template.
Signed webhooks
Get a webhook when a code is delivered, verified or fails, carrying your own reference. You choose where each channel's events go.
A log of every code
Search by number or address, status or channel in the web app, and see which channel carried a code, how it ended and what it cost.
Limits against fraud
Limit codes per number or address and per hour, send only to the countries you serve, and cap what a day can cost. Fraud protection
Codes kept private
Codes are stored encrypted and hidden in your message log. Only the phone or inbox they went to ever shows them.
How is this different from sending a code as a message?
With a plain message you make the code, store it and check it yourself. OTP does that for you. It also expires each code, stops accepting it after too many wrong tries and tries Telegram before SMS.
What if the person is not on Telegram?
The code goes by SMS straight away, and you pay for the SMS only.
Can I use SMS only, or Telegram only?
Yes. Each request can name one channel, or both in the order you want.
Can I send codes by email?
Yes. Send an email address instead of a phone number and the code goes by email, from your company's name, at one price for any address. A code by email never falls back to SMS or Telegram, so offer email to the people who prefer it.
Do I need a sender ID?
For SMS codes, yes: an approved sender ID of your own. Codes sent only by Telegram, or by email, need none.
Can I change the wording of the code message?
On SMS, yes. Write your own text or keep it in a template, in any language. On Telegram, Telegram writes the message itself, and a code by email comes in a short email from your company's name.
Who can see the codes?
Only the person they were sent to. Codes are stored encrypted and hidden in the message log, from you and from our staff.
Send a code to your own phone on free credits
Sign up and we review your account, usually within a business day. Then verify your number and send to it on free test credits. Add a sender and credits when you are ready for real traffic.
Free test credits to start. You don't need a card, and there's no monthly fee or contract.

