返回 JSON，错误遵循 problem+json 标准。每个请求都需要账户页面中的 API 令牌。
GET /v1/services 获取服务 id 和价格。POST /v1/rentals 租号，并保存返回的 id。GET /v1/rentals/{id}，直到 status 不再是 0。status 1 表示验证码已在 code 字段中；status 2 表示 4–7 分钟内没收到验证码，费用已退回。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> 请求头，令牌为账户页面中的 32 位令牌。不要把令牌放在 URL 里。?lang=en 或 ?lang=zh，或发送 X-Lang: en 请求头，错误的 detail 即以英文或中文返回。默认为越南语；code 和数据不变。账户当前余额。
{
"balance": 186500
}租号时 carriers 字段使用的运营商名称。越南：MOBIFONE、VINAPHONE、VIETTEL、VIETNAMOBILE、ITELECOM、WINTEL、GTEL。老挝：UNITEL、ETL、BEELINE、LAOTEL。列表中还有其他市场的运营商，暂未使用。
[
{
"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"
}
]支持 API 的服务的 id、名称和价格。价格可能变动，请定期重新获取列表。
[
{
"id": 7,
"name": "Facebook",
"price": 800
},
{
"id": 1,
"name": "Momo",
"price": 350
}
]为服务租一个新号码。立即扣费，4–7 分钟内没收到验证码自动退款。
{
"serviceId": 1,
"carriers": [
"VINAPHONE",
"VIETTEL"
],
"includePrefixes": [
"096",
"097",
"098"
]
}{
"id": 1234122,
"phone": "0987654321",
"phoneLocal": "987654321",
"countryIso": "VN",
"countryCode": "84",
"balance": 185300
}为同一服务重新租用同一个号码，例如 App 要求再次验证时。仅限上次租号后约 15–30 分钟内，且该 SIM 仍在系统中。
{
"serviceId": 1,
"phone": "0987654321"
}{
"id": 1234190,
"phone": "0987654321",
"phoneLocal": "987654321",
"countryIso": "VN",
"countryCode": "84",
"balance": 184700
}某次租号的状态和验证码。每 5 秒调用一次，直到 status 不再是 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"
}按服务、状态和日期范围筛选的租号记录，最新的在前。5 个参数都必填。
[
{
"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 đủ !"
}