Skip to main content
TingTing lets you send OTPs to users via voice call or text (SMS). You can either provide your own OTP or let TingTing auto-generate one.
Always use the {otp} placeholder in your message rather than hardcoding the OTP value. TingTing replaces the placeholder at delivery time, keeping your code clean and your OTP logic flexible.

​
Send OTP

POST https://app.tingting.io/api/v1/auths/send/otp/
Sends an OTP to a single recipient via voice call or SMS. Requires a Bearer token in the Authorization header.

​
Parameters

​
number
string
required
Recipient’s phone number.
​
message
string
required
Message text to deliver. Must include the {otp} placeholder where the OTP value should appear, e.g. "Hi Your OTP is {otp}".
​
sms_send_options
string
required
Delivery method. Accepted values: "voice" or "text".
​
otp_options
string
default:"generated"
Controls whether you supply the OTP or TingTing generates it. Accepted values: "personnel" (provide your own OTP) or "generated" (auto-generate). Defaults to "generated".
​
otp
string
Your custom OTP value. Required when otp_options is "personnel".
​
otp_length
integer
Length of the auto-generated OTP. Only applies when otp_options is "generated".
​
voice_input
string
Voice name for the call. Required when sms_send_options is "voice". Accepted values: "np_rija", "np_prashanna", "np_shreegya", "np_binod".
The {otp} placeholder in your message is replaced with the actual OTP value before the message is delivered — whether via voice or text.

​
Example requests

{
    "number": "9851023212",
    "message": "Hi your OTP is {otp}",
    "sms_send_options": "text",
    "otp_options": "personnel",
    "otp": "12345"
}

​
Responses

{
    "status": 200,
    "success": true,
    "message": "OTP Sent Successfully.",
    "errors": [],
    "data": {
        "details": {
            "number": "9861489014",
            "otp_options": "personnel",
            "message": "हेल्लो नमस्ते",
            "otp": "564546",
            "sms_send_options": "text",
            "credits_used": 1,
            "remaining_sms_credits": 62,
            "remaining_phone_credits": 127
        }
    }
}

​
List sent OTPs

GET https://app.tingting.io/api/v1/auths/list/send-otps/
Returns a paginated list of all OTPs you have sent. Requires a Bearer token in the Authorization header.

​
Example response

{
    "count": 2,
    "total_pages": 1,
    "next": null,
    "previous": null,
    "results": {
        "status": 200,
        "success": true,
        "errors": [],
        "data": [
            {
                "id": 12,
                "phone_number": "9861489014",
                "message": "Hi, your otp is 12345",
                "otp": "12345",
                "otp_options": "personnel",
                "sms_send_options": "text",
                "created_at": "2025-10-29T13:33:55.512191+05:45"
            }
        ]
    }
}

​
Response fields

​
count
integer
Total number of OTP records across all pages.
​
total_pages
integer
Total number of pages available.
​
next
string
URL to the next page of results. null if you are on the last page.
​
previous
string
URL to the previous page of results. null if you are on the first page.
​
results
object