Skip to main content
GET
/
10dlc
/
brand
/
smsOtp
/
{referenceId}
JavaScript
import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const response = await client.messaging10dlc.brand.retrieveSMSOtpStatus('OTP4B2001');

console.log(response.brandId);
{
  "brandId": "B123ABC",
  "referenceId": "OTP4B2001",
  "mobilePhone": "+11234567890",
  "requestDate": "2024-12-03T17:12:33.560000+00:00",
  "deliveryStatus": "DELIVERED_HANDSET",
  "verifyDate": "2024-12-03T17:12:33.560000+00:00",
  "deliveryStatusDate": "2024-12-03T17:12:33.560000+00:00",
  "deliveryStatusDetails": "Delivered to handset"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
referenceId
string
required

The reference ID returned when the OTP was initially triggered

Example:

"OTP4B2001"

Query Parameters

​
brandId
string

Filter by Brand ID for easier lookup in portal applications

Example:

"B123ABC"

Response

Successful Response

Status information for an SMS OTP sent during Sole Proprietor brand verification

​
brandId
string
required

The Brand ID associated with this OTP request

Example:

"B123ABC"

​
referenceId
string
required

The reference ID for this OTP request, used for status queries

Example:

"OTP4B2001"

​
mobilePhone
string
required

The mobile phone number where the OTP was sent, in E.164 format

Example:

"+11234567890"

​
requestDate
string<date-time>
required

The timestamp when the OTP request was initiated

Example:

"2024-12-03T17:12:33.560000+00:00"

​
deliveryStatus
string
required

The current delivery status of the OTP SMS message. Common values include: DELIVERED_HANDSET, PENDING, FAILED, EXPIRED

Example:

"DELIVERED_HANDSET"

​
verifyDate
string<date-time>

The timestamp when the OTP was successfully verified (if applicable)

Example:

"2024-12-03T17:12:33.560000+00:00"

​
deliveryStatusDate
string<date-time>

The timestamp when the delivery status was last updated

Example:

"2024-12-03T17:12:33.560000+00:00"

​
deliveryStatusDetails
string

Additional details about the delivery status

Example:

"Delivered to handset"