hello@siellabs.com We reply within one business day Docs Pricing Contact
Siel

Products

Messaging API Campaigns SMPP and wholesale OTP

Platform

Analytics Delivery quality Fraud protection

For partners

Partner console Routing and analytics

Company

Contact Pricing Developers Sign in Send your first SMS free

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.

  1. 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.

  2. 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.

  3. 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.
POST /v1/verifications
// 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.

OTP questions

Anything not answered here, ask us. We reply within one business day.

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.