GET US States

Get the list of available states for number requests. Include your API key as a Bearer token.

GEThttps://otpverified.com/api/v1/users/us-states
Authorization: Bearer YOUR_API_KEY

{
"statusCode": 200,
 "data": {
        "AK": "AK",
        "AL": "AL",
        "AR": "AR",
        ...
    },
"message": "States retrieved successfully",
"success":  true
}

GET Services

Fetch services of server one with updated pricing including special discounted pricing if you got any. Include your API key as a Bearer token.

GEThttps://otpverified.com/api/v1/users/server1-pricing
Authorization: Bearer YOUR_API_KEY

{
"statusCode": 200,
"data": [
        {
            "serviceId": "1fe58df2",
            "serviceName": "Google",
            "otpPrice": "0.45"
        },
        ....
        ],
"message": "Services retrieved successfully",
"success":  true
}

GET Number Details

Retrieve detailed information for a specific number. Include your API key as a Bearer token.

GEThttps://otpverified.com/api/v1/users/number-details-s1?orderId=52608714
Authorization: Bearer YOUR_API_KEY

{
"statusCode": 200,
"data": {
        "createdAt": "2025-05-23 15:10:10" // Timezone: Etc/UTC (UTC+00:00),
        "orderId": "52608714",
        "number": "19128648532",
        "serviceName": "Google",
        "country": "United States",
        "state": "NY",
        "otpPrice": "0.45",
        "status": "completed",
        "message": "",
        "pin": "111222"
       },
"message": "Services retrieved successfully",
"success":  true
}

Request Params Properties

Property	Type	Required	Description
OrderId	String	Yes	Order ID as returned in the request-s1-service or reuse-s1-service API response

Request Number

Request a number by providing the `serviceId` in your API call.

POSThttps://otpverified.com/api/v1/users/request-s1-service
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Request Body:
{
  "serviceId": "6b816098",
  "state": "NY",
  "requestPremium": 100
}

Request Body Properties

Property	Type	Required	Description
serviceId	String	Yes	Service Id (as returned by server-1-pricing api or seen on Pricing page)
state	String	No	A 2-character US state abbreviation. If this parameter is passed we will try to provide a number from a specific state.
requestPremium	Number	No	A numeric value, between 10 and 2000 for Premium requests feature. If passed, and there are no number available for a particular service, the request will be created with “Pending” status and a lifetime of 30 minutes. If during that time an number becomes available, and there are several users that placed bids, it will be given to the one who placed the highest bid earlier than others. The status of the request will then change to “Reserved”. You can monitor the status of the request using “number-details” api. Also, if you have configured a callback URL, you will receive an event of “s1_win_premium_request” type if your bid has won.

{
   "statusCode": 201,
    "data": {
        "orderId": "52608714",
        "number": "19128648532",
        "serviceName": "Google",
        "status": "reserved",
        "state": "",
        "requestPremium": 0, // default 0
        "otpPrice": "0.45",
        "expiredIn": 900
    },
    "message": "Request Successful!",
    "success": true
}

Reuse Number

Request a number by providing the `orderId` in your API call.

POSThttps://otpverified.com/api/v1/users/reuse-s1-service
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Request Body:
{
  "orderId": "52608714",
}

Request Body Properties

Property	Type	Required	Description
OrderId	String	Yes	Order ID as returned in the request-s1-service API response

{
   "statusCode": 201,
    "data": {
        "orderId": "52608714",
        "number": "19128648532",
        "serviceName": "Google",
        "status": "reserved",
        "state": "",
        "requestPremium": 0, // default 0
        "otpPrice": "0.25",
        "expiredIn": 900
    },
    "message": "Request Successful!",
    "success": true
}

Reject Number

Request a number by providing the `orderId` in your API call.

POSThttps://otpverified.com/api/v1/users/reject-s1-service
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Request Body:
{
  "orderId": "52608714",
}

Request Body Properties

Property	Type	Required	Description
OrderId	String	Yes	Order ID as returned in the request-s1-service or reuse-s1-service API response

{
   "statusCode": 200,
    "data": null,
    "message": "Number has been rejected Successfully",
    "success": true
}