API Documentation

Integrate virtual phone number services into your applications. Compatible with 365sms API format. Responses use plain text for core operations and JSON for data queries.

Base URL: https://rentverify.us/api/v1

Authentication

All API requests require your access token.

X-API-Token Header (recommended)
Pass your 64-character hex token via custom header.

X-API-Token: your_64_char_hex_token_here

Authorization Bearer
Alternatively, use standard Bearer token format.

Authorization: Bearer your_64_char_hex_token_here

Your token is displayed after sign-up and on your account page. It is a 64-character hexadecimal string. Keep it secret.

Response Format

The API uses two response formats depending on the endpoint.

Important: Core operations (balance, buy, status, cancel) return plain text responses for 365sms compatibility. Data queries (countries, services, prices, active list) return JSON.

Plain Text Responses

Balance, Buy, Status, Cancel

ACCESS_BALANCE:25.50
ACCESS_NUMBER:12345:+12025551234
STATUS_OK:834921
STATUS_WAIT_CODE
ACCESS_CANCEL

JSON Responses

Countries, Services, Prices, Active list

[
  {"id": "usa", "name": "United States"},
  {"id": "england", "name": "England"}
]

Account

Check your balance and view active numbers.

GET /api/v1/getBalance Get account balance

Example Request

curl -X GET "https://rentverify.us/api/v1/getBalance" \
  -H "X-API-Token: YOUR_TOKEN"

Response

ACCESS_BALANCE:25.50

GET /api/v1/getActiveActivations List active numbers (JSON)

Example Request

curl -X GET "https://rentverify.us/api/v1/getActiveActivations" \
  -H "X-API-Token: YOUR_TOKEN"

Response

[
  {
    "id": 12345,
    "number": "+12025551234",
    "service": "tg",
    "country": "usa",
    "status": "active",
    "cost": 0.50,
    "expires_at": "2026-03-08T14:30:00",
    "created_at": "2026-03-08T14:15:00"
  }
]

Products & Prices

Browse available countries, services, and prices. All return JSON.

GET /api/v1/getCountries List available countries

Example Request

curl -X GET "https://rentverify.us/api/v1/getCountries" \
  -H "X-API-Token: YOUR_TOKEN"

Response

[
  { "id": "usa", "name": "United States" },
  { "id": "england", "name": "England" },
  { "id": "india", "name": "India" }
]

GET /api/v1/getServices?country={id} Services for a country

Query Parameters

Parameter	Type	Required	Description
`country`	string	Required	Country ID (e.g., "usa", "england")

Example Request

curl -X GET "https://rentverify.us/api/v1/getServices?country=usa" \
  -H "X-API-Token: YOUR_TOKEN"

Response

[
  { "code": "tg", "name": "Telegram" },
  { "code": "wa", "name": "WhatsApp" },
  { "code": "facebook", "name": "Facebook" }
]

GET /api/v1/getPrices All prices (nested JSON)

Returns a nested object: {country_id: {service_code: {price, available, price_id}}}. Use price_id when buying to specify exact provider/price.

Example Request

curl -X GET "https://rentverify.us/api/v1/getPrices" \
  -H "X-API-Token: YOUR_TOKEN"

Response

{
  "usa": {
    "tg": { "price": 0.50, "available": 120, "price_id": "MTo..." },
    "wa": { "price": 1.20, "available": 85, "price_id": "MTo..." }
  },
  "england": {
    "tg": { "price": 0.75, "available": 64, "price_id": "MTo..." }
  }
}

Number Operations

Buy numbers, check SMS status, and cancel orders. All return plain text.

GET /api/v1/getNumber?service={code}&country={id} Buy a number

Query Parameters

Parameter	Type	Required	Description
`service`	string	Required	Service code (e.g., "tg", "wa", "facebook")
`country`	string	Required	Country ID (e.g., "usa", "england")
`price_id`	string	Optional	Specific price ID from getPrices. If omitted, cheapest is used.

Example Request

curl -X GET "https://rentverify.us/api/v1/getNumber?service=tg&country=usa" \
  -H "X-API-Token: YOUR_TOKEN"

Success Response

ACCESS_NUMBER:12345:+12025551234

Format: ACCESS_NUMBER:{number_id}:{phone_number}
Save the number_id to check status and receive SMS later.

Error Responses

NO_NUMBERS    — No numbers available for this service/country
NO_BALANCE    — Insufficient balance
BAD_ACTION    — Missing or invalid parameters

GET /api/v1/getStatus?id={number_id} Check status / get SMS code

Query Parameters

Parameter	Type	Required	Description
`id`	integer	Required	Number ID from getNumber response

Example Request

curl -X GET "https://rentverify.us/api/v1/getStatus?id=12345" \
  -H "X-API-Token: YOUR_TOKEN"

Possible Responses

Response	Meaning
`STATUS_WAIT_CODE`	Waiting for SMS. Poll again in 3-5 seconds.
`STATUS_OK:{code}`	SMS received! The verification code is after the colon.
`STATUS_CANCEL`	Number was cancelled or expired.

Typical Polling Flow

# 1. Buy number
ACCESS_NUMBER:12345:+12025551234

# 2. Use the phone number to register on the target service

# 3. Poll for SMS (every 3-5 seconds)
STATUS_WAIT_CODE    ← keep polling
STATUS_WAIT_CODE    ← keep polling
STATUS_OK:834921    ← SMS received! Code is 834921

GET /api/v1/setStatus?id={number_id}&status=8 Cancel a number

Query Parameters

Parameter	Type	Required	Description
`id`	integer	Required	Number ID to cancel
`status`	integer	Required	Must be `8` (cancel)

Example Request

curl -X GET "https://rentverify.us/api/v1/setStatus?id=12345&status=8" \
  -H "X-API-Token: YOUR_TOKEN"

Success Response

ACCESS_CANCEL

A refund is applied minus a $0.10 cancellation fee. You cannot cancel a number that has already received SMS.

Error Reference

Common error responses and their meanings.

Response	HTTP	Description
`BAD_KEY`	401	Invalid or missing API token. Check your X-API-Token header.
`NO_ACTIVATION`	403	Account does not have permission. Only "user" or "admin" roles can use the API.
`BAD_ACTION`	400	Missing required parameters or invalid parameter values.
`NO_NUMBERS`	404/503	No numbers available for the requested service/country, or provider error.
`NO_BALANCE`	402	Insufficient balance. Top up your account first.

Complete Example

Full workflow: buy a Telegram number in the USA and receive SMS code.

# 1. Check balance
curl -s "https://rentverify.us/api/v1/getBalance" -H "X-API-Token: YOUR_TOKEN"
# → ACCESS_BALANCE:25.50

# 2. Buy a Telegram number in USA
curl -s "https://rentverify.us/api/v1/getNumber?service=tg&country=usa" -H "X-API-Token: YOUR_TOKEN"
# → ACCESS_NUMBER:12345:+12025551234

# 3. Use +12025551234 to register on Telegram...

# 4. Poll for SMS code
curl -s "https://rentverify.us/api/v1/getStatus?id=12345" -H "X-API-Token: YOUR_TOKEN"
# → STATUS_WAIT_CODE  (keep polling every 3-5 sec)

curl -s "https://rentverify.us/api/v1/getStatus?id=12345" -H "X-API-Token: YOUR_TOKEN"
# → STATUS_OK:834921  (done! code is 834921)

# 5. If you need to cancel (before SMS arrives):
curl -s "https://rentverify.us/api/v1/setStatus?id=12345&status=8" -H "X-API-Token: YOUR_TOKEN"
# → ACCESS_CANCEL