Skip to content

Developer API

Cascade REST API

Everything you need to integrate OTP and short links: endpoints, errors, limits, webhooks, and SDKs.

Quick Answer

Base URL: https://cascade.kz/api. Auth — Authorization: Bearer <token>. OpenAPI: https://cascade.kz/openapi.yaml.

Summary

Cascade API accepts Bearer-token requests and delivers verification codes via WhatsApp, Telegram, or SMS.

Key Takeaways

  • Create an API key in the company cabinet.
  • Send OTP with POST /otp/send.
  • Verify codes with POST /otp/verify.
  • SMS costs more than messengers — account for token billing.

API

Cascade API key — Bearer authorization

How to create an API key in the Cascade cabinet and use Authorization Bearer for cascade.kz/api.

API

Cascade token balance

How to understand WhatsApp, Telegram and SMS token charges in Cascade.

API

Cascade API errors

HTTP codes 401, 422, 429 and the success field in Cascade OTP API responses.

API

Cascade API request examples

Ready curl examples for send, verify, shorten and links/send for Cascade OTP.

API

Cascade send history

Where to view OTP and delivery history in the Cascade cabinet.

API

Cascade API rate limits

Limits on OTP send frequency and verify attempts in Cascade.

API

Cascade API response formats

Structure of Cascade JSON responses: success, message, expires_in, short_url.

API

POST /otp/send — send OTP

How to send a one-time code via Cascade API: phone, purpose, channel, link.

API

Cascade API short links

Shorten and send links: POST /links/shorten and POST /links/send.

API

Cascade delivery and response statuses

How to interpret success, message and typical OTP statuses in Cascade.

API

Cascade balance top-up

How to top up tokens for sending OTP via WhatsApp, Telegram and SMS in Cascade.

API

POST /otp/verify — verify code

Verify an OTP code via Cascade API: phone, code, purpose.

API

Cascade Webhooks — section status

Information about Cascade OTP webhooks: rely on synchronous send/verify responses.

SDK

Cascade OTP in C#

Cascade OTP API integration example in C# via HttpClient. An official package may not exist.

SDK

Cascade OTP in Go

Cascade OTP API integration example in Go via net/http. An official package may not exist.

SDK

Cascade OTP in Java

Cascade OTP API integration example in Java via HttpClient. An official package may not exist.

SDK

Cascade OTP in JavaScript

Cascade OTP API integration example in JavaScript via fetch. An official package may not exist.

SDK

Cascade OTP in PHP

Cascade OTP API integration example in PHP via cURL / Laravel Http. An official package may not exist.

SDK

Cascade OTP in Python

Cascade OTP API integration example in Python via requests. An official package may not exist.

SDK

Cascade OTP in Rust

Cascade OTP API integration example in Rust via reqwest. An official package may not exist.

SDK

Cascade OTP in TypeScript

Cascade OTP API integration example in TypeScript via fetch. An official package may not exist.