---
title: "Get Brand SMS OTP Status"
method: GET
path: "/10dlc/brand/smsOtp/{referenceId}"
tags: ["Brands"]
---

# Get Brand SMS OTP Status

`GET /10dlc/brand/smsOtp/{referenceId}`

Query the status of an SMS OTP (One-Time Password) for Sole Proprietor brand verification.

This endpoint allows you to check the delivery and verification status of an OTP sent during the Sole Proprietor brand verification process. You can query by either:

* `referenceId` - The reference ID returned when the OTP was initially triggered
* `brandId` - Query parameter for portal users to look up OTP status by Brand ID

The response includes delivery status, verification dates, and detailed delivery information.

## Path parameters

- `referenceId` string, required

## Query parameters

- `brandId` string

## Response `200`

Successful Response

- BrandSmsOtpStatus — Status information for an SMS OTP sent during Sole Proprietor brand verification
  - `brandId` string, required — The Brand ID associated with this OTP request
  - `referenceId` string, required — The reference ID for this OTP request, used for status queries
  - `mobilePhone` string, required — The mobile phone number where the OTP was sent, in E.164 format
  - `requestDate` string, date-time, required — The timestamp when the OTP request was initiated
  - `verifyDate` string, date-time — The timestamp when the OTP was successfully verified (if applicable)
  - `deliveryStatus` string, required — The current delivery status of the OTP SMS message. Common values include: `DELIVERED_HANDSET`, `PENDING`, `FAILED`, `EXPIRED`
  - `deliveryStatusDate` string, date-time — The timestamp when the delivery status was last updated
  - `deliveryStatusDetails` string — Additional details about the delivery status

## Other responses

- `404` — OTP reference not found
- `422` — Validation Error
- `4XX` — Generic response error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)