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/rental-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/rental-pricing
Authorization: Bearer YOUR_API_KEY

{
"statusCode": 200,
"data": [
        {
            "serviceId": "1fe58df2",
            "serviceName": "Google",
            "threeDayLTRPrice": "2.27"
            "thirtyDayLTRPrice": "10.78"
        },
        ....
        ],
"message": "Services retrieved successfully",
"success":  true
}

GET Messages

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

GEThttps://otpverified.com/api/v1/users/rental-messages?orderId=52608714
Authorization: Bearer YOUR_API_KEY

{
"statusCode": 200,
"data": {
       "messages": 
          [
              {
                "id": "b903e75c",
                "orderId": "765268",
                "timestamp": "2025-07-11 13:50:49 EDT",
                "service": "GMail",
                "sender": "22000",
                "number": "16097641010",
                "message": "G-276964 is your Google verification code.",
                "pin": "G-276964"
              },
              ...
         ]  
       },
"message": "Rental Messages retrieved successfully",
"success":  true
}

Request Params Properties

Property	Type	Required	Description
OrderId	String	Yes	Order ID as returned in the request-rental or renew-rental API response

Request Number

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

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

Request Body Properties

Property	Type	Required	Description
serviceId	String	Yes	Service Id (as returned by rental-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.
duration	Number	Yes	Rental duration, in days. Can equal to 3 or 30 days. Please note that not all Numbers may support 3-day rentals. Accepted Value 3 or 30 (Number)

{
   "statusCode": 201,
    "data": {
        "orderId": "52608714",
        "number": "19128648532",
        "serviceName": "Google",
        "state": "NY",
        "duration": 3, 
        "purchased": "2025-04-26 12:43:00", // Timezone: Etc/UTC (UTC+00:00),
        "expires": "2025-04-29 12:43:00",
        "price": "3.46",
        "onlineStatus": "offline",
        "status": "reserved",
    },
    "message": "Order Confirmed!",
    "success": true
}

Renew Number

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

POSThttps://otpverified.com/api/v1/users/renew-rental
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-rental API response

{
   "statusCode": 201,
    "data": {
        "orderId": "52608714",
        "number": "19128648532",
        "serviceName": "Google",
        "state": "NY",
        "duration": 3, 
        "purchased": "2025-04-26 12:43:00", // Timezone: Etc/UTC (UTC+00:00),
        "expires": "2025-04-29 12:43:00",
        "price": "3.46",
        "onlineStatus": "offline",
        "status": "reserved",
    },
    "message": "Request Successful!",
    "success": true
}

Activate Number

Activate a rental number by providing the orderId of an existing rental order. This endpoint communicates with the provider to check the number status and activate it if eligible.

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

Request Body Properties

Property	Type	Required	Description
orderId	String	Yes	The unique ID of the rental order (returned from `request-rental` or `renew-rental` API).

{
  "statusCode": 200,
  "data": {
   "orderId": "52608714",
   "number": "19128648532",
   "onlineStatus": "online",
   "offlineIn": 270
   "onlineIn": null
   }
   "message": "Number Successfully activated",
   "success": true,
}

Release Number

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

POSThttps://otpverified.com/api/v1/users/release-rental
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-rental or renew-rental API response

{
   "statusCode": 200,
   "message": "Number successfully released",
   "success": true
}