Kết quả trả về JSON, lỗi theo chuẩn problem+json. Mọi request cần token API trong trang tài khoản.
GET /v1/services để lấy id dịch vụ và giá.POST /v1/rentals với serviceId để thuê số, giữ lại id.GET /v1/rentals/{id} một lần cho tới khi status khác 0. status 1 là đã có mã trong trường code, status 2 là đã chờ 4–7 phút mà không có mã và tiền đã được hoàn.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> trong mọi request, token 32 ký tự lấy trong trang tài khoản. Không đặt token trên URL.?lang=en hoặc ?lang=zh vào URL, hoặc gửi header X-Lang: en, để detail của lỗi trả về bằng tiếng Anh hoặc tiếng Trung. Mặc định là tiếng Việt; code và dữ liệu không đổi.Số dư hiện tại của tài khoản.
{
"balance": 186500
}Tên nhà mạng dùng cho trường carriers khi thuê số. Việt Nam: MOBIFONE, VINAPHONE, VIETTEL, VIETNAMOBILE, ITELECOM, WINTEL, GTEL. Lào: UNITEL, ETL, BEELINE, LAOTEL. Danh sách trả về còn có nhà mạng của thị trường khác, hiện chưa dùng.
[
{
"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, tên và giá của các dịch vụ mở cho API. Giá có thể thay đổi, nên lấy lại danh sách định kỳ.
[
{
"id": 7,
"name": "Facebook",
"price": 800
},
{
"id": 1,
"name": "Momo",
"price": 350
}
]Thuê một số mới cho dịch vụ. Tiền bị trừ ngay, sau 4–7 phút không có mã thì tự hoàn lại.
{
"serviceId": 1,
"carriers": [
"VINAPHONE",
"VIETTEL"
],
"includePrefixes": [
"096",
"097",
"098"
]
}{
"id": 1234122,
"phone": "0987654321",
"phoneLocal": "987654321",
"countryIso": "VN",
"countryCode": "84",
"balance": 185300
}Thuê lại đúng số đã dùng cho cùng dịch vụ, ví dụ khi app đòi xác minh lần nữa. Chỉ được trong khoảng 15–30 phút sau lượt thuê trước và khi sim còn trên hệ thống.
{
"serviceId": 1,
"phone": "0987654321"
}{
"id": 1234190,
"phone": "0987654321",
"phoneLocal": "987654321",
"countryIso": "VN",
"countryCode": "84",
"balance": 184700
}Trạng thái và mã OTP của một lượt thuê. Gọi lại mỗi 5 giây cho tới khi status khác 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"
}Các lượt thuê lọc theo dịch vụ, trạng thái và khoảng ngày, mới nhất trước. Cả 5 tham số đều bắt buộc.
[
{
"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 đủ !"
}