API Reference

The RentiumSMS API allows you to automate SMS verifications at scale. Use our professional endpoints to manage numbers, services, and incoming codes programmatically.

Global Reach

Instantly connect with users in over 150 countries without any complicated setup.

Instant Updates

Get real-time SMS notifications sent directly to your app as soon as they arrive.

Built to Grow

Whether you need ten messages a day or ten million, our system handles it smoothly.

Secure Access

Keep your app safe with industry-standard security and private API keys.

Endpoint Reference

All requests must be made over HTTPS and require a valid Bearer token.

Method	Path	Description
GET	/v1/services	List all platforms supported for verification (WhatsApp, Google, etc.).
GET	/v1/countries	Get availability and pricing across 150+ supported countries.
GET	/v1/operators	Retrieve a list of mobile carriers available for a specific country.
POST	/v1/reservations	Order a new private number for a specific service and operator.
GET	/v1/reservations/{id}	Check the current status and details of an active number rental.
GET	/v1/reservations/{id}/sms	Retrieve incoming verification codes for your active number.
GET	/v1/balance	Check your current wallet balance and active account quotas.

curl -X POST "https://api.rentiumsms.online/v1/reservations" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "service": "whatsapp",
       "country": "us",
       "operator": "any"
     }'

Webhooks Integration

Real-Time
SMS Delivery

Set up webhooks to receive high-speed HTTP POST callbacks directly to your server API as soon as a verification code arrives. Skip polling completely for highly scalable workflows.

Instant Event Types

sms.received

Example JSON Payload

{
  "event": "sms.received",
  "timestamp": "2026-05-19T21:16:00Z",
  "data": {
    "reservation_id": "res_84920fd83a",
    "phone_number": "+12025550143",
    "service": "whatsapp",
    "sender": "WhatsApp",
    "text": "Your WhatsApp verification code is 849-201",
    "code": "849201"
  }
}

Error Reference

Error Codes & Rate Limits

RentiumSMS implements clear HTTP status returns to allow your backend code to handle exceptions and fail gracefully.

400 BAD_REQUEST

Invalid parameters, missing body fields, or unsupported country code.

401 UNAUTHORIZED

Invalid, missing, or expired Bearer API authentication token.

402 OUT_OF_BALANCE

Insufficient wallet balance to cover the requested phone line reservation.

429 RATE_LIMIT

API request threshold exceeded (limit of 10 requests per second per account).

503 CARRIER_TIMEOUT

Temporary carrier provider outage. Re-attempt the reservation after 60 seconds.

Start Renting Now.

The example above shows how to programmatically request a new WhatsApp verification number in the USA. Once the reservation is created, you can poll the SMS endpoint or set up a webhook callback to receive your code.

Network Uptime

99.9%

Guaranteed