Documentation

Getting started

Authenticate, buy a number, then poll for the code. Three steps from zero to a verified sign-up.

1. Authenticate

Create a key in your API settings and send it as a Bearer token on every request.

curl https://otpwave.com/api/v1/services \
  -H "Authorization: Bearer nh_live_••••"

2. Check prices, then buy

List the operators for a service and country, most reliable first. Each option shows its delivery rate and the exact price you pay through the API (in NGN, reseller discount included).

curl "https://otpwave.com/api/v1/availability?country=US&service=whatsapp" \
  -H "Authorization: Bearer nh_live_••••"

Then create an activation. Leave out operator to get the recommended (most reliable) number, or pass one from the list. The response includes the assigned number, the activation id, and the price you were charged in currency.

curl -X POST https://otpwave.com/api/v1/activations \
  -H "Authorization: Bearer nh_live_••••" \
  -H "Content-Type: application/json" \
  -d '{ "country": "US", "service": "whatsapp" }'

3. Read the code

Poll the activation until the code arrives. If it expires without a code, it's refunded automatically.

curl https://otpwave.com/api/v1/activations/ACTIVATION_ID \
  -H "Authorization: Bearer nh_live_••••"

Next steps

Browse every endpoint in the API overview.
Cancel while waiting with POST /v1/activations/:id/cancel.
Send an Idempotency-Key header on purchases so a retried request never buys twice.

Build with OTPWave

Create an account, generate a key, and make your first call in minutes.

Create account See pricing