Answers are JSON, errors follow problem+json. Every request needs the API token from your account page.
GET /v1/services to get service ids and prices.POST /v1/rentals with the serviceId to rent a number, and keep the id.GET /v1/rentals/{id} every 5 seconds until status is no longer 0. status 1 means the code is in the code field; status 2 means 4–7 minutes passed without a code and the money was refunded.curl -X POST "https://api.otpvn.com/v1/rentals" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"serviceId":1}'
curl "https://api.otpvn.com/v1/rentals/1234122" -H "Authorization: Bearer YOUR_API_TOKEN"const BASE = 'https://api.otpvn.com';
const TOKEN = 'YOUR_API_TOKEN';
async function call(method, path, body) {
const res = await fetch(BASE + path, {
method,
headers: { Authorization: 'Bearer ' + TOKEN, 'Content-Type': 'application/json' },
body: body ? JSON.stringify(body) : undefined,
});
const data = await res.json();
if (!res.ok) throw new Error(data.code + ': ' + data.detail);
return data;
}
const rent = await call('POST', '/v1/rentals', { serviceId: 1 });
console.log('Number:', rent.phoneLocal);
for (;;) {
await new Promise((r) => setTimeout(r, 5000));
const s = await call('GET', '/v1/rentals/' + rent.id);
if (s.status === 1) { console.log('Code:', s.code); break; }
if (s.status === 2) { console.log('Expired, refunded'); break; }
}import time
import requests
BASE = "https://api.otpvn.com"
HEADERS = {"Authorization": "Bearer YOUR_API_TOKEN"}
def call(method, path, body=None):
res = requests.request(method, BASE + path, headers=HEADERS, json=body, timeout=30)
data = res.json()
if not res.ok:
raise RuntimeError(f'{data["code"]}: {data["detail"]}')
return data
rent = call("POST", "/v1/rentals", {"serviceId": 1})
print("Number:", rent["phoneLocal"])
while True:
time.sleep(5)
s = call("GET", f"/v1/rentals/{rent['id']}")
if s["status"] == 1:
print("Code:", s["code"])
break
if s["status"] == 2:
print("Expired, refunded")
break<?php
const BASE = 'https://api.otpvn.com';
const TOKEN = 'YOUR_API_TOKEN';
function call(string $method, string $path, ?array $body = null): array {
$ch = curl_init(BASE . $path);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . TOKEN, 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $body === null ? null : json_encode($body),
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) throw new Exception($data['code'] . ': ' . $data['detail']);
return $data;
}
$rent = call('POST', '/v1/rentals', ['serviceId' => 1]);
echo 'Number: ' . $rent['phoneLocal'] . PHP_EOL;
while (true) {
sleep(5);
$s = call('GET', '/v1/rentals/' . $rent['id']);
if ($s['status'] === 1) { echo 'Code: ' . $s['code'] . PHP_EOL; break; }
if ($s['status'] === 2) { echo 'Expired, refunded' . PHP_EOL; break; }
}https://api.otpvn.comAuthorization: Bearer <token> header with every request, using the 32-character token from your account page. Never put the token in the URL.?lang=en or ?lang=zh to the URL, or send the X-Lang: en header, to get the error detail in English or Chinese. Vietnamese is the default; code and the data stay the same.The account's current balance.
{
"balance": 186500
}Carrier names for the carriers field when renting. Vietnam: MOBIFONE, VINAPHONE, VIETTEL, VIETNAMOBILE, ITELECOM, WINTEL, GTEL. Laos: UNITEL, ETL, BEELINE, LAOTEL. The list also has carriers of other markets that are not used yet.
[
{
"id": 1,
"name": "MOBIFONE"
},
{
"id": 2,
"name": "VINAPHONE"
},
{
"id": 3,
"name": "VIETTEL"
},
{
"id": 4,
"name": "VIETNAMOBILE"
},
{
"id": 5,
"name": "ITELECOM"
},
{
"id": 6,
"name": "VODAFONE_RO"
},
{
"id": 7,
"name": "WINTEL"
},
{
"id": 8,
"name": "METFONE"
},
{
"id": 9,
"name": "UNITEL"
},
{
"id": 10,
"name": "ETL"
},
{
"id": 11,
"name": "BEELINE"
},
{
"id": 12,
"name": "LAOTEL"
},
{
"id": 13,
"name": "GTEL"
}
]Id, name and price of the services open to the API. Prices can change, so fetch the list again from time to time.
[
{
"id": 7,
"name": "Facebook",
"price": 800
},
{
"id": 1,
"name": "Momo",
"price": 350
}
]Rents a new number for the service. The price is charged right away and refunded automatically if no code arrives within 4–7 minutes.
{
"serviceId": 1,
"carriers": [
"VINAPHONE",
"VIETTEL"
],
"includePrefixes": [
"096",
"097",
"098"
]
}{
"id": 1234122,
"phone": "0987654321",
"phoneLocal": "987654321",
"countryIso": "VN",
"countryCode": "84",
"balance": 185300
}Rent the same number again for the same service, e.g. when an app asks to verify again. Only within about 15–30 minutes of the previous rental, and while the SIM is still on the system.
{
"serviceId": 1,
"phone": "0987654321"
}{
"id": 1234190,
"phone": "0987654321",
"phoneLocal": "987654321",
"countryIso": "VN",
"countryCode": "84",
"balance": 184700
}Status and OTP of a rental. Call it every 5 seconds until status is no longer 0.
{
"id": 1234122,
"serviceId": 1,
"serviceName": "Momo",
"price": 600,
"status": 1,
"content": "486460 la ma xac thuc Momo cua ban",
"code": "486460",
"isAudio": false,
"phone": "0987654321",
"phoneLocal": "987654321",
"countryIso": "VN",
"countryCode": "84",
"createdAt": "2026-09-27T10:15:24.88+07:00"
}Rentals filtered by service, status and date range, newest first. All 5 parameters are required.
[
{
"id": 1234101,
"serviceId": 1,
"serviceName": "Momo",
"price": 600,
"status": 1,
"content": "https://audio.otpvn.com/20260927101215_7f3c2a.wav",
"code": "731905",
"isAudio": true,
"phone": "0987654321",
"phoneLocal": "987654321",
"countryIso": "VN",
"countryCode": "84",
"createdAt": "2026-09-27T10:12:03.51+07:00"
}
]{
"type": "https://otpvn.com/errors/insufficient_balance",
"title": "Unprocessable Entity",
"status": 422,
"code": "insufficient_balance",
"detail": "Số dư quý khách không đủ !"
}