REST
rentiumsms api v2.0

build impossible workflows

seamlessly integrate our vast catalog of virtual identity assets and long-term numbers directly into your own infrastructure.

introduction

welcome to the official rentiumsms rest api! our platform provides programmatic access to a vast network of long-term rented mobile numbers, social identities, and custom utility assets. with this api, you can seamlessly integrate our inventory into your own applications, automate order flows, and construct impossible workflows without a single click.

authentication

all requests to the rentiumsms api must be authenticated using a bearer token. you can generate a persistent token from your developer settings, or generate a temporary session token via the api directly.

Authorization: Bearer rp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxx

rate limits

to maintain optimal performance across our systems, rentiumsms enforces rate limits based on your account tier. core endpoints are typically limited to 60 requests per minute. if you exceed this threshold, the api will respond with a 429 too many requests status.

errors

rentiumsms api utilizes standard http response codes to indicate the success or failure of requests. all error responses include a structured json body with an error property describing exactly what went wrong.

{
  "success": false,
  "error": "Insufficient wallet balance to provision rental.",
  "status": 402
}

endpoint reference

real-time interactive documentation with professional code examples.

POST/api/auth/token

Generate API Token

Create a session-bound API token for headless authentication. Use this token in the Authorization header for all subsequent requests.

requires auth
json response

request example

const axios = require('axios');

const response = await axios.post('https://api.rentiumsms.com/api/auth/token', {
  email: 'user@example.com',
  password: 'your_secure_password'
});

console.log(response.data.data.token);

example response

{
  "success": true,
  "data": {
    "token": "rp_a8f9c21..."
  }
}

need api keys?

head over to the developers console to generate your live secrets securely.

open dashboard