Cascade REST API
Everything you need to integrate login OTP: endpoints, errors, limits, webhooks, and SDKs.
-
01
Cascade API key — Bearer authorization
How to create an API key in the Cascade cabinet and use Authorization Bearer for cascade.kz/api.
-
02
Cascade token balance
How to understand WhatsApp, Telegram and SMS token charges in Cascade.
-
03
Cascade API errors
HTTP codes 401, 422, 429 and the success field in Cascade OTP API responses.
-
04
Cascade API request examples
Ready curl examples for send, verify, shorten and links/send for Cascade OTP.
-
05
Cascade send history
Where to view OTP and delivery history in the Cascade cabinet.
-
06
Cascade API rate limits
Limits on OTP send frequency and verify attempts in Cascade.
-
07
Cascade API response formats
Structure of Cascade JSON responses: success, message, expires_in, short_url.
-
08
POST /otp/send — send OTP
How to send a one-time code via Cascade API: phone, purpose, channel, link.
-
09
Cascade API short links
Shorten and send links: POST /links/shorten and POST /links/send.
-
10
Cascade delivery and response statuses
How to interpret success, message and typical OTP statuses in Cascade.
-
11
Cascade balance top-up
How to top up tokens for sending OTP via WhatsApp, Telegram and SMS in Cascade.
-
12
POST /otp/verify — verify code
Verify an OTP code via Cascade API: phone, code, purpose.
-
13
Cascade Webhooks — section status
Information about Cascade OTP webhooks: rely on synchronous send/verify responses.