API Reference

WhatsApp OTP API Reference

Production API reference for sending WhatsApp OTP messages through the DNZ engine.

Authentication

  • Generate the API key from the WhatsApp OTP dashboard.
  • Send the key in the JSON body as apiKey because the current engine route validates apiKey from the request body.
  • Keep the API key on your backend only. Do not expose it in React, Flutter, or public browser code.
POST/api/send-otp

Queue a WhatsApp OTP or transactional verification message.

Request example

{
  "apiKey": "wb_live_xxxxxxxxxxxxx",
  "number": "+9647878785391",
  "message": "Your DNZ verification code is 482910"
}

Response example

{
  "jobId": "a8f1c4f3d1",
  "accepted": true
}

Error codes

  • 400 missing_fields
  • 400 invalid_number
  • 401 invalid_api_key
  • 429 plan or rate limit reached
  • 500 send_otp_failed

Rate limits

  • The public route applies a 120 requests per minute limiter per API key or IP.
  • Plan limits also apply before queueing, including monthly usage, daily usage for the free plan, minimum interval, and available WhatsApp slots.

Continue with