OTP API for Kazakhstan

Send verification codes via API

WhatsApp, Telegram, SMS and incoming call in one service, with a webhook for every status. Works on all Kazakhstan carriers, from 2 tenge per code.

Try it free → Send a code to yourself

WhatsApp OTP — code in the messenger

The code arrives as an official WhatsApp message with a “Copy code” button. You pay only for delivered codes. Supported languages: Russian, Kazakh and English.

  • ✓ “Copy code” button right in the message
  • ✓ Russian, Kazakh and English
  • ✓ Charged only for a delivered code, from 11 ₸
AutoCall.kz ✓
4821 is your verification code. For your security, do not share this code.
The code is valid for 2 minutes
⧉ Copy code
POST from 11 ₸
/api/v1/otp/whatsapp
POST /api/v1/otp/whatsapp
Authorization: Bearer {your_token}
Content-Type: application/json
{
  "number": "+77010000000",
  "code": "4821",
  "language": "ru",
  "callback_url": "https://example.kz/otp-hook"
}
201 Created
response
← 201 Created
{
  "id": 1042,
  "channel": "whatsapp",
  "number": "+77010000000",
  "code": "4821", // save it for checking
  "language": "ru",
  "status": "sent",
  "expires_at": "2026-11-02 10:02:00"
}

2

Telegram OTP — code from the official bot

Telegram OTP

The code arrives in Telegram from the official “Verification Codes” bot. If the number has no Telegram, you learn this right away in the response to the request, free of charge.

  • ✓ Delivered in seconds
  • ✓ No Telegram: instant 422 no_telegram, no charge
  • ✓ Your code or ours, 4 to 8 digits
  • ✓ Charged only for a delivered code, from 7 ₸
Verification Codes ✓
AutoCall.kz
Your code is 4821. Do not share it with anyone.
official Telegram bot
POST from 7 ₸
/api/v1/otp/telegram — your own code
POST /api/v1/otp/telegram
Authorization: Bearer {your_token}
Content-Type: application/json
{
  "number": "+77010000000",
  "code": "4821" // your own code, 4–8 digits; or code_length
}
422 Unprocessable
if the number has no Telegram
← 422 Unprocessable
{
  "error": "no_telegram",
  "message": "This number has no Telegram. Send the code through another channel."
}

3

SMS with a verification code

SMS OTP

The classic way: an SMS with the code from the sender AUTOCALL.KZ. Works on any phone and without internet, on all Kazakhstan carriers: Kcell, Activ, Tele2, Beeline, izi, Altel.

  • ✓ Delivered in 10–40 seconds
  • ✓ Works without internet
  • ✓ Code autofill on iOS and Android
  • ✓ Company name in the text: “Clinic Plus code: 66767”
POST from 18.95 ₸
/api/v1/otp/sms
POST /api/v1/otp/sms
Authorization: Bearer {your_token}
Content-Type: application/json
{
  "number": "+77010000000",
  "code": "66767",
  "brand": "Clinic Plus"
}
201 Created
response
← 201 Created
{
  "id": 1043,
  "channel": "sms",
  "number": "+77010000000",
  "code": "66767",
  "brand": "Clinic Plus",
  "status": "sent",
  "expires_at": "2026-11-02 10:02:00"
}

4

Incoming call — the user makes the call

  1. The user enters a number On your website or in your app: +7 701 123 45 67.
  2. Your server requests a number to call A POST /api/v1/otp/incoming-call request; the response has a call_to field.
  3. The app shows a button The button opens the dialer right away: tel:+77470000000.
  4. The user makes the call From the same number. We see who is calling and where. What they hear depends on type.
  5. You get a webhook Status verified: the number is confirmed. No call within 2 minutes: expired.
  6. Done The user is signed in. No code to enter.
Method What you show the user What they hear when calling Price
Missed call missed Just the “Call” button A busy signal. We do not pick up, so the call is free for them from 2 ₸
Listen listen The “Call” button and a code input field An automated voice says your company name and the code from 5 ₸
Dial press The “Call” button and the code to dial “Dial the code on your phone keypad” from 3 ₸
Say say The “Call” button and the digits or word to say “Say the code.” The user says it out loud in Russian or Kazakh from 7 ₸

Good to know

  • The call must come from the number you passed in number. A call from another number does not count.
  • A hidden caller ID will not work: such calls are dropped right away.
  • The call_to number works only for this user and only for ttl seconds: 120 by default, from 30 to 300.
  • A new request for the same number cancels the previous one: the old call_to stops working.
  • With listen, press and say we pick up, and the user pays for the call as a regular outgoing call on their own plan. The missed option is free for them.

The user calls and we reject the call without answering, then the webhook arrives with the status verified. The call is free for the user.

POST from 2 ₸
/api/v1/otp/incoming-call — missed
POST /api/v1/otp/incoming-call
Authorization: Bearer {your_token}
Content-Type: application/json
{
  "number": "+77010000000",
  "type": "missed",
  "callback_url": "https://example.kz/otp-hook"
}
201 Created
response
← 201 Created
{
  "id": 1044,
  "channel": "incoming-call",
  "type": "missed",
  "number": "+77010000000",
  "code": null, // no code, the call itself verifies
  "call_to": "+77470940670", // show: “Call this number”
  "status": "pending",
  "expires_at": "2026-11-02 10:02:00"
}

5

Voice call with a code

Flash Call and voice verification codes by outbound call are not available for calls to Kazakhstan. Under clause 3-1 of Article 21 of the Law of the Republic of Kazakhstan “On Communications” (as amended by Law No. 320-VIII of June 19, 2026), since August 20, 2026 telecom operators may not carry automated calls that deliver identification and authentication codes. This includes calls that drop before or after the first ring (Flash Call) and calls with a voice code (Voice Call OTP). Mobile operators must reject such calls, so we have had to stop providing these services. To verify phone numbers, use WhatsApp OTP, Telegram OTP, SMS OTP or an inbound call (Incoming Call OTP). Inbound call OTP is a direct replacement for Flash Call.
Audio
voice OTP example
“Verification code: 3 0 7 5. Once again: 3 0 7 5.”
Voice OTP

AutoCall.kz calls the user and reads out the code with text-to-speech. Handy when the user is driving, has poor eyesight, or when SMS is blocked by a corporate carrier. How it works and what it costs →

  • ✓ Text-to-speech in Russian and Kazakh
  • ✓ The code is repeated several times
  • ✓ Works without internet
  • ✓ Cheaper than SMS

Separate the code digits with a space: 3 0 7 5. This way the speech engine reads them one by one with a natural pause. Commas between digits stretch the pauses and make the call noticeably longer.

POST
/api/v1/autocalls
POST /api/v1/autocalls
Authorization: Bearer {your_token}
Accept: application/json
Content-Type: application/json
{
  "name": "Verification Code",
  "type": "regular",
  "audio_id": [{
    "type": "synthesis",
    "data": {
      "text": "Verification code: 3 0 7 5. Once again: 3 0 7 5."
    }
  }],
  "list_id": [
    { "number": "+77010000000" }
  ]
}
201 Created
response
← 201 Created
{
  "id": 67890,
  "client_id": null,
  "name": "Regular autocall",
  "status": "running",
  "time_from": "00:00:00",
  "time_to": "23:59:59",
  "max_cost": 9.16,
  "record": false,
  "callback_url": null,
  "created_at": "2020-04-14 04:09:16",
  "updated_at": "2020-04-14 04:09:16"
}

6

Flash Call — verification by the last digits of the number

Flash Call and voice verification codes by outbound call are not available for calls to Kazakhstan. Under clause 3-1 of Article 21 of the Law of the Republic of Kazakhstan “On Communications” (as amended by Law No. 320-VIII of June 19, 2026), since August 20, 2026 telecom operators may not carry automated calls that deliver identification and authentication codes. This includes calls that drop before or after the first ring (Flash Call) and calls with a voice code (Voice Call OTP). Mobile operators must reject such calls, so we have had to stop providing these services. To verify phone numbers, use WhatsApp OTP, Telegram OTP, SMS OTP or an inbound call (Incoming Call OTP). Inbound call OTP is a direct replacement for Flash Call.
Flash Call OTP

The fastest and cheapest method. AutoCall.kz calls from a number whose last digits are the code. The call is dropped automatically. The user sees the number on the screen and enters the last digits.

  • ✓ The cheapest OTP
  • ✓ The code appears in 3–10 seconds
  • ✓ Works without internet
  • ✓ The user does not answer the call
POST from 2 ₸
auto code (we generate it)
POST /api/v1/flash-calls
Authorization: Bearer {your_token}
Accept: application/json
Content-Type: application/json
{
  "number": "+77010000000",
  "digits": 5 // Auto code supports 3 to 6 digits
}
201 Created from 2 ₸
response — auto code
← 201 Created
{
  "id": 11223,
  "code": "72511", // save it to check on your side
  "number": "+77010000000"
}
POST from 2 ₸
your own code (you set it)
POST /api/v1/flash-calls
Authorization: Bearer {your_token}
Accept: application/json
Content-Type: application/json
{
  "number": "+77010000000",
  "code": "3075"
}
201 Created from 2 ₸
response — your own code
← 201 Created
{
  "id": 11224,
  "code": "3075",
  "number": "+77010000000"
}
When you send your own code, you are very likely to get error 422, because the mobile provider may not yet have given us a number whose last digits match your code. Please use the Auto code feature until we acquire 1 million numbers from providers.

One API for all channels

The same statuses, code check and webhook. You change only the channel in the request URL

pending → sent → delivered → read → verified or expired failed
POST
check the entered code
POST /api/v1/otp/{id}/check
Authorization: Bearer {your_token}
Content-Type: application/json
{
  "code": "4821"
}
200 OK
5 attempts per code (3 in a call)
← 200 OK
{
  "valid": true,
  "status": "verified",
  "attempts_left": 4
}
POST
webhook to your callback_url
POST https://example.kz/otp-hook
{
  "otp": {
    "id": 1045,
    "channel": "incoming-call",
    "type": "press",
    "number": "+77010000000",
    "status": "verified",
    "verified_at": "2026-11-02 10:00:41",
    "cost": 4
  }
}
errors
response to POST /api/v1/otp/{channel}
402 insufficient_balance // top up your balance
422 no_telegram // number has no Telegram
422 country_not_allowed // number or channel not available for this country
429 too_many_requests // 5 codes per 10 minutes per number
451 law_restricted // flash is banned in Kazakhstan
503 provider_unavailable // retry or switch the channel

The full description is in the OpenAPI specification. You build a “WhatsApp → SMS” cascade on your side using these codes and statuses.

OTP cost calculator

What a code costs in each channel on your plan

Plan
Channel
Codes per month
One code
11 ₸
Per month

WhatsApp and Telegram are charged only for delivered codes, SMS for sent ones, and the incoming call when the number is issued. Your plan depends on the top-up amount.

Try it now

Verify your own number the way your users will, free and with no sign-up

Method
Your number

The demo is limited to two codes per number per day. Your account has no such limits.

OTP channel comparison

Pick a channel for the task or build a cascade: messenger → SMS → call

Feature WhatsApp Telegram SMS Inbound call
Price per code from 11 ₸ from 7 ₸ from 18.95 ₸ from 2 ₸
What you pay for per delivered code per delivered code per sent code when the number is issued
Speed 1–5 sec 1–5 sec 10–40 sec while the user is calling
User needs internet yes yes ✓ no ✓ no
What the user does Copies the code Copies the code Reads the SMS Calls the number
Your company name ✓ in the text ✗ ✓ in the text ✓ in the voice
If the channel is unavailable webhook no_whatsapp instant 422 — —
Monthly fee No No No No

Three steps to get started

You can launch your first verification in 15 minutes

1

Sign up

Create an account on AutoCall.kz. Sign-up is free, and a test balance is added automatically.

2

Get an API token

In your dashboard → “API” section → create a key and copy it.

3

Send your first OTP

POST /api/v1/otp/whatsapp with a number, and the user gets the code. Check it with one request or a webhook.

Verification code pricing

No monthly fee or contract. Your plan depends on the top-up amount

Direction
BRONZE
5 ₸—
per code by inbound callunavailable in this country
any payment
Verification codes (OTP)
  • WhatsApp 19.5 ₸ each
  • Telegram 12 ₸ each
  • SMS 37.3 ₸ eachunavailable
  • Inbound call: missed call 5 ₸ eachunavailable
  • Inbound: listen to the code 12 ₸ eachunavailable
  • Inbound: dial the code 6 ₸ eachunavailable
  • Inbound: say the code 14 ₸ eachunavailable
SILVER
3 ₸—
per code by inbound callunavailable in this country
payment from 30 000 ₸
Verification codes (OTP)
  • WhatsApp 13.5 ₸ each
  • Telegram 9 ₸ each
  • SMS 23.25 ₸ eachunavailable
  • Inbound call: missed call 3 ₸ eachunavailable
  • Inbound: listen to the code 8 ₸ eachunavailable
  • Inbound: dial the code 4 ₸ eachunavailable
  • Inbound: say the code 10 ₸ eachunavailable
GOLD
2 ₸—
per code by inbound callunavailable in this country
payment from 2 000 000 ₸
Verification codes (OTP)
  • WhatsApp 11 ₸ each
  • Telegram 7 ₸ each
  • SMS 18.95 ₸ eachunavailable
  • Inbound call: missed call 2 ₸ eachunavailable
  • Inbound: listen to the code 5 ₸ eachunavailable
  • Inbound: dial the code 3 ₸ eachunavailable
  • Inbound: say the code 7 ₸ eachunavailable

Countries and channels

Kazakhstan: all channels. Other countries: WhatsApp and Telegram codes to mobile numbers.

Country WhatsApp Telegram SMS Inbound call
Kazakhstan 13.5 ₸ 9 ₸ 23.25 ₸ from 3 ₸
Azerbaijan 16 ₸ 9 ₸ unavailable unavailable
Armenia 16 ₸ 9 ₸ unavailable unavailable
Belarus 16 ₸ 9 ₸ unavailable unavailable
Georgia 16 ₸ 9 ₸ unavailable unavailable
Kyrgyzstan 6 ₸ 9 ₸ unavailable unavailable
Moldova 16 ₸ 9 ₸ unavailable unavailable
Russia 30 ₸ 9 ₸ unavailable unavailable
Tajikistan 8.5 ₸ 9 ₸ unavailable unavailable
Turkmenistan 8.5 ₸ 9 ₸ unavailable unavailable
Uzbekistan 8.5 ₸ 9 ₸ unavailable unavailable
Ukraine 16 ₸ 9 ₸ unavailable unavailable

Price per delivered code. In WhatsApp it depends on the country; in Telegram it is the same everywhere. For inbound call the missed-call price is shown; reading out or dialing a code costs more. Pass the number in E.164 format, for example +998901234567.

All pricing: calls, SMS, AI agents →

Frequently asked questions

How do I send a verification code via API?

One request: POST /api/v1/otp/{channel}, where channel is whatsapp, telegram, sms or incoming-call. The response contains the request id, the code and the status. To check the code the user entered, call POST /api/v1/otp/{id}/check. Statuses (sent, delivered, verified) arrive by webhook at your callback_url. You need a Bearer API token from your dashboard.

Which verification method is cheapest?

The cheapest is an incoming call in missed-call mode: from 2 ₸, and the call is free for the user because we reject it without answering. Telegram costs from 7 ₸, WhatsApp from 11 ₸, SMS from 18.95 ₸. For WhatsApp and Telegram we charge only for delivered codes.

What happens to Flash Call and voice codes?

Since August 20, 2026, clause 3-1 of article 21 of the Law of the Republic of Kazakhstan “On Communications” bans operators from carrying automated calls with codes, so Flash Call and voice codes on AutoCall.kz are discontinued as of November 1, 2026. The closest replacement is the incoming call: the user calls the number from the API response, and we either reject the call or read out the code.

How is the incoming call different from Flash Call?

With Flash Call, we made the call. With an incoming call, the user calls the number you get in the call_to field and show on the screen. It is not an automated call with a code. There are four options: missed call (we reject it without answering), listen to the code, enter the code on the keypad, and say the code aloud.

What if the user has no WhatsApp or Telegram?

Telegram tells you right away: the POST returns 422 with the code no_telegram, and you are not charged. WhatsApp reports it later with a webhook carrying the status failed and the reason no_whatsapp. In both cases, send the code through another channel: SMS or an incoming call.

How do I know the code was delivered or verified?

Set callback_url in the request or once in your account settings. Every status change sends a POST with the otp object: sent, delivered, read, verified, expired, or failed with a reason. Or poll GET /api/v1/otp/{id}.

Can I put my company name in the message?

Yes, the brand field takes up to 30 characters: the name is spoken in the incoming call and in the call with the code. A moderator checks each new name once. On WhatsApp the code arrives without a name: your own name and number will appear once you connect your own WhatsApp account.

Does verification work if the user has no internet?

SMS and incoming call do, since they go over the cellular network. WhatsApp and Telegram need internet on the phone.

How do I get an API token?

Sign up at AutoCall.kz → dashboard → “API” section → “Create key”. Pass the key in the Authorization: Bearer header.

Other AutoCall.kz tools

Combine channels to reach more people

Start sending OTP codes today

Sign up and get a test balance right away.
WhatsApp, Telegram, SMS and incoming call are available now.

Sign up free →