Skip to main content
OTPBay verifies phone numbers. You send us a phone number, we deliver a one-time code over Telegram or SMS, and you check the code your user types in. When Telegram can’t reach someone, OTPBay switches to SMS on its own. You pay per message from a prepaid USD balance. There are no subscriptions or minimums, and new accounts start with $1.00 of free credit.

Quickstart

Verify your first phone number in about five minutes.

API reference

Every endpoint, with a playground to try requests.

​
Pick an API

Verify

Start a verification and check the code. OTPBay generates the code, picks the channel and falls back to SMS.

SMS

Send any text message from an approved alphanumeric sender ID.

Telegram

Send a code straight to a Telegram account, for less than an SMS.
For sign-up and login codes, use Verify. It handles code generation, expiry, retry limits, fallback and refunds for you. Use the SMS and Telegram APIs directly only when you need full control.

​
How it fits together

  1. Create a project in the dashboard and copy an API key.
  2. Call the API from your backend with Authorization: Bearer <key>.
  3. Follow each message with its sid, or receive webhooks when its status changes.
  4. Watch costs, refunds and delivery in the dashboard’s Analytics and Ledger pages.

​
Learn more

Authentication

API keys and the IP allowlist.

Webhooks

Get status updates pushed to your server.

Errors

Status codes and every error code the API returns.

Billing

Prices, charges and automatic refunds.