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/server2-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-s2?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",
        "areas": "503,210",
        "carrier": "Verizon",
        "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-s2-service or reuse-s2-service API response

Request Number

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

POSThttps://otpverified.com/api/v1/users/request-s2-service
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Request Body:
{
  "serviceId": "6b816098",
  "areas": "503,210",
  "carrier": vz
}

Request Body Properties

Property	Type	Required	Description
serviceId	String	Yes	Service Id (as returned by server-2-pricing api or seen on Pricing page)
areas	String	No	You can specify area codes in the “areas” query string parameter. For example, areas=212,718 will only rent numbers with area codes 212 or 718. Note: Preferred area codes Increases price by 20%.
carrier	String	No	You can specify carrier in the “carriers” query string parameter. You need to use “tmo” for T-Mobile, “vz” for Verizon, and “att” for AT&T. Note: Preferred carrier Increases price by 20%.

{
   "statusCode": 201,
    "data": {
        "orderId": "52608714",
        "number": "19128648532",
        "serviceName": "Google",
        "status": "reserved",
        "areas": "503,210",
        "carrier": "Verizon",
        "otpPrice": "0.45",
        "expiredIn": 420
    },
    "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-s2-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-s2-service API response

{
   "statusCode": 201,
   "data": {
        "orderId": "52608714",
        "number": "19128648532",
        "serviceName": "Google",
        "status": "reserved",
        "areas": "503,210",
        "carrier": "Verizon",
        "otpPrice": "0.45",
        "expiredIn": 420
        "onlineIn": 120 // you will get this value if the number gets offline
    },
    "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-s2-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-s2-service or reuse-s2-service API response

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