跳到主要内容
网站标志TextVerification
开发者

API 文档

通过您自己的代码订购号码、读取验证码并管理租用。API 与控制台共用同一余额和价格，适用于所有产品。

  • 基于 HTTPS 的 REST 与 JSON
  • Bearer API 密钥
  • 支持重试的回调
  • 每分钟 100 次请求
  • 与控制台价格相同

入门

发送第一个请求前需要了解的一切：地址、身份验证、响应格式以及可能遇到的错误。

基础 URL

https://textverification.io/api/v1/users

身份验证

以 Bearer 令牌形式发送 API 密钥：Authorization: Bearer YOUR_API_KEY。在账户设置中生成密钥，并仅将其保存在您的服务器上：任何持有密钥的人都可以花费您的余额。

请求与响应

请求体以 JSON 格式发送（也支持表单字段）。所有响应均为 JSON，包含 statusCode、success、message 和 data；价格以美元计，为保留两位小数的字符串。

快速开始

订购一个 Pinpoint 号码并读取其验证码。其他产品的用法完全相同。

cURL
curl -X POST "https://textverification.io/api/v1/users/request-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1fe58df2"}'
Node.js
const API = "https://textverification.io/api/v1/users";
const headers = {
  Authorization: `Bearer ${process.env.API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Order a number
const order = await fetch(`${API}/request-s2-service`, {
  method: "POST",
  headers,
  body: JSON.stringify({ serviceId: "1fe58df2" }),
}).then((res) => res.json());

// 2. Read the order (or set a callback URL instead of polling)
const { data } = await fetch(
  `${API}/number-details-s2?orderId=${order.data.orderId}`,
  { headers }
).then((res) => res.json());
Python
import os, requests

API = "https://textverification.io/api/v1/users"
headers = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

# 1. Order a number
order = requests.post(f"{API}/request-s2-service",
                      json={"serviceId": "1fe58df2"}, headers=headers).json()

# 2. Read the order (or set a callback URL instead of polling)
details = requests.get(f"{API}/number-details-s2",
                       params={"orderId": order["data"]["orderId"]},
                       headers=headers).json()
print(details["data"]["status"], details["data"]["pin"])

错误

状态码说明
400请求无效，或余额不足以支付订单。
401API 密钥缺失、无效或未启用。
403当前不允许此操作，例如未完成订单过多或账户受限。
404订单或服务不存在，或不属于您。
409订单当前无法变更（已完成或已取消），或其价格刚刚发生变化。
422某个选项无效，例如未知的区号或租用时长。
429请求过多：请降低频率，稍后重试。
503该产品当前不可用。请稍后重试或使用其他产品。

建议使用回调而非轮询：验证码一到达，回调就会立即通知您的服务器。如果确需轮询订单，请在两次请求之间等待几秒。

速率限制

每个 IP 地址每分钟最多可发送 100 次请求，每个 API 密钥在所有地址上合计每分钟最多 600 次。每个响应都带有 RateLimit-Remaining 和 RateLimit-Reset 响应头。超出限制的请求将收到 429，并附带 Retry-After 响应头说明需等待的秒数。使用回调可让您的请求量远低于该限制。

确保集成安全

  • 请将 API 密钥保存在您的服务器上：切勿放在移动应用、浏览器代码或公开代码仓库中。
  • 如果密钥可能已泄露，请在账户设置中生成新密钥。旧密钥将立即失效。
  • 回调 URL 必须使用 HTTPS。请在路径中加入难以猜测的令牌，并在处理每个回调前，确认其中的 orderId 属于您下过的订单。
  • 您的密钥消耗的是您的余额：请通过余额接口查询余额，并在大批量下单前充值。

查询余额

返回您的账户余额（美元）。

GET/balance
请求示例
curl "https://textverification.io/api/v1/users/balance" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": "120.50",
  "message": "Request Successful!",
  "success": true
}

Prime

可选择州的美国号码，以及针对缺货服务的高级请求。

列出服务和价格

列出 Prime 的服务以及每项服务扣除折扣后的价格。

GET/server1-pricing
请求示例
curl "https://textverification.io/api/v1/users/server1-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "2264119e",
      "serviceName": "WhatsApp",
      "price": "1.30"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

查询含选项的服务价格

返回某项服务在您所选选项下的价格。

GET/server1-price
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
areaCodestring否3 位美国区号，例如 "212"，用于获取该区号的号码。区号优先于州，并可能增加价格。
requestPremiumnumber否针对缺货服务的溢价：订单将以待处理状态等待，有号码可用时即可抢得号码。
请求示例
curl "https://textverification.io/api/v1/users/server1-price?serviceId=2264119e&areaCode=212&requestPremium=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "serviceId": "2264119e",
    "serviceName": "WhatsApp",
    "areaCode": "212",
    "requestPremium": 20,
    "price": "1.56"
  },
  "message": "Request Successful!",
  "success": true
}

列出美国州

列出可指定的美国州。

GET/us-states
请求示例
curl "https://textverification.io/api/v1/users/us-states" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "CA": "CA",
    "FL": "FL",
    "NY": "NY",
    "TX": "TX"
  },
  "message": "Request Successful!",
  "success": true
}

订购号码

为某项服务订购一个 Prime 号码，并从余额中扣费。

POST/request-s1-service
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
statestring否美国州代码，例如 "NY"，用于获取该州的号码。
areaCodestring否3 位美国区号，例如 "212"，用于获取该区号的号码。区号优先于州，并可能增加价格。
requestPremiumnumber否针对缺货服务的溢价：订单将以待处理状态等待，有号码可用时即可抢得号码。

使用溢价时，缺货订单将以待处理状态等待；抢得号码后，您会收到 s1_win_premium_request 回调。

请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"2264119e","state":"NY"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "status": "reserved",
    "state": "NY",
    "areaCode": "",
    "requestPremium": 0,
    "price": "1.30",
    "expiredIn": 900
  },
  "message": "Request Successful!",
  "success": true
}

获取订单

返回订单及其状态；验证码到达后，一并返回验证码。

GET/number-details-s1
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/number-details-s1?orderId=55655059" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "country": "United States",
    "state": "NY",
    "areaCode": "",
    "price": "1.30",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

复用号码

在服务允许的情况下，再次订购同一号码以接收另一个验证码。

POST/reuse-s1-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reuse-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"55655059"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "55655059",
    "number": "12125550101",
    "serviceName": "WhatsApp",
    "country": "United States",
    "state": "NY",
    "areaCode": "",
    "price": "1.30",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

取消号码

取消尚未收到验证码的号码，并将费用退回您的余额。

POST/reject-s1-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reject-s1-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"55655059"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Pinpoint

可自选区号和运营商的美国号码，通过短信或（在支持的情况下）语音来电接收验证码。

列出服务和价格

列出 Pinpoint 的服务以及每项服务扣除折扣后的价格。

GET/server2-pricing
请求示例
curl "https://textverification.io/api/v1/users/server2-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "1fe58df2",
      "serviceName": "google"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

查询含选项的服务价格

返回某项服务在您所选选项下的价格。

GET/server2-price
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
areasstring否可选区号，用逗号分隔（最多 10 个），例如 "212,646"。会增加价格。
carrierstring否可选运营商，用逗号分隔：tmo（T-Mobile）、vz（Verizon）、att（AT&T）。会增加价格。
capabilitystring否"sms"（默认），或 "voice"，在支持语音来电时通过来电接收验证码。
请求示例
curl "https://textverification.io/api/v1/users/server2-price?serviceId=1fe58df2&areas=212%2C646&carrier=vz" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "serviceName": "google",
    "price": "1.53",
    "capability": "sms",
    "areaCode": true,
    "carrier": true
  },
  "message": "Request Successful!",
  "success": true
}

列出区号

列出可指定的美国区号及其所属州。

GET/server2-area-codes
请求示例
curl "https://textverification.io/api/v1/users/server2-area-codes" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "areaCode": "212",
      "state": "New York"
    },
    {
      "areaCode": "503",
      "state": "Oregon"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

订购号码

为某项服务订购一个 Pinpoint 号码，并从余额中扣费。

POST/request-s2-service
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
areasstring否可选区号，用逗号分隔（最多 10 个），例如 "212,646"。会增加价格。
carrierstring否可选运营商，用逗号分隔：tmo（T-Mobile）、vz（Verizon）、att（AT&T）。会增加价格。
capabilitystring否"sms"（默认），或 "voice"，在支持语音来电时通过来电接收验证码。

语音订单（capability 为 "voice"）需使用 Twilio 的 Voice SDK 和语音令牌接口返回的令牌接听。来电到达时订单即完成，订单详情中会列出该通话。

请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1fe58df2","areas":"212,646","carrier":"vz,att"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "status": "reserved",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

获取订单

返回订单及其状态；验证码到达后，一并返回验证码。

GET/number-details-s2
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/number-details-s2?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "country": "United States",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

复用号码

在服务允许的情况下，再次订购同一号码以接收另一个验证码。

POST/reuse-s2-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reuse-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"lr_01K7ABC"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "number": "12125550102",
    "serviceName": "google",
    "country": "United States",
    "areas": "212,646",
    "carrier": "vz,att",
    "capability": "sms",
    "price": "1.53",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

取消号码

取消尚未收到验证码的号码，并将费用退回您的余额。

POST/reject-s2-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reject-s2-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"lr_01K7ABC"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

获取语音通话令牌

返回一个短期有效的令牌，用于通过 Twilio 的 Voice SDK 接听语音订单的来电。

GET/s2-voice-token
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/s2-voice-token?orderId=lr_01K7ABC" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "lr_01K7ABC",
    "token": "eyJhbGciOi…",
    "expiresIn": 540
  },
  "message": "Request Successful!",
  "success": true
}

下载通话录音

返回语音订单的通话录音（如有保留）。

GET/s2-voice-recording
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
callIdstring是通话 ID，来自订单的通话记录。
请求示例
curl "https://textverification.io/api/v1/users/s2-voice-recording?orderId=lr_01K7ABC&callId=call_8f2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
(audio file)

Flex

一个订单中可指定多个区号和一家运营商，适用于美国及其他可选国家。

列出服务和价格

列出 Flex 的服务以及每项服务扣除折扣后的价格。

GET/server3-pricing
参数类型必填说明
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/server3-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "9a1c55e0",
      "serviceName": "Telegram",
      "price": "0.40"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

列出国家

列出 Flex 提供号码的国家/地区及其代码。

GET/server3-countries
请求示例
curl "https://textverification.io/api/v1/users/server3-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

订购号码

为某项服务订购一个 Flex 号码，并从余额中扣费。

POST/request-s3-service
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
areasstring否区号，用逗号分隔（最多 10 个）。会增加价格。
carrierstring否"att" 或 "tmo"。会增加价格。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"9a1c55e0","areas":"212,646","carrier":"tmo"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "status": "reserved",
    "areas": "212,646",
    "carrier": "tmo",
    "price": "0.58",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

获取订单

返回订单及其状态；验证码到达后，一并返回验证码。

GET/number-details-s3
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/number-details-s3?orderId=48211973" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.58",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

复用号码

在服务允许的情况下，再次订购同一号码以接收另一个验证码。

POST/reuse-s3-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reuse-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"48211973"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "48211973",
    "number": "16465550103",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.58",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

取消号码

取消尚未收到验证码的号码，并将费用退回您的余额。

POST/reject-s3-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reject-s3-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"48211973"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Global

来自众多国家的号码：先获取国家列表，再在其中一个国家为某项服务订购号码。

列出服务和价格

列出 Global 的服务以及每项服务扣除折扣后的价格。

GET/server4-pricing
参数类型必填说明
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/server4-pricing?country=gb" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "c41e7a02",
      "serviceName": "WhatsApp",
      "price": "0.35"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

列出国家

列出 Global 提供号码的国家/地区及其代码。

GET/server4-countries
请求示例
curl "https://textverification.io/api/v1/users/server4-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    },
    {
      "code": "gb",
      "name": "United Kingdom"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

获取验证方式和运营商选项

返回某服务在某国家/地区能否通过 FlashCall + 短信验证，以及号码可能来自的运营商，并附每个选项的价格。

GET/server4-options
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/server4-options?serviceId=c41e7a02&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "price": "2.70",
    "call": {
      "price": "3.00"
    },
    "carriers": {
      "surcharge": 20,
      "operators": [
        {
          "code": "at_t",
          "name": "AT&T"
        },
        {
          "code": "tmobile",
          "name": "T-Mobile"
        },
        {
          "code": "verizon",
          "name": "Verizon"
        }
      ],
      "price": "3.24",
      "callPrice": "3.60"
    }
  },
  "message": "Request Successful!",
  "success": true
}

订购号码

为某项服务订购一个 Global 号码，并从余额中扣费。

POST/request-s4-service
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
verificationstring否"call" 表示 FlashCall + 短信：服务拨打该号码，来电号码即验证码。默认为 "sms"。
operatorstring否选项接口中的运营商代码，仅获取该运营商的号码，并加收运营商附加费。默认任意运营商。
请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"c41e7a02","country":"us","operator":"tmobile"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "3.24",
    "expiredIn": 1200,
    "carrier": "T-Mobile"
  },
  "message": "Request Successful!",
  "success": true
}

获取订单

返回订单及其状态；验证码到达后，一并返回验证码。

GET/number-details-s4
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/number-details-s4?orderId=3311842" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.24",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

复用号码

在服务允许的情况下，再次订购同一号码以接收另一个验证码。

POST/reuse-s4-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reuse-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"3311842"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "3311842",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.24",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

取消号码

取消尚未收到验证码的号码，并将费用退回您的余额。

POST/reject-s4-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reject-s4-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"3311842"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Smart

来自众多国家的低价号码，支持区号、优先级，每次请求最多 5 个号码。

列出服务和价格

列出 Smart 的服务以及每项服务扣除折扣后的价格。

GET/server5-pricing
参数类型必填说明
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/server5-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "7d0f3b11",
      "serviceName": "Telegram",
      "price": "0.12"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

列出国家

列出 Smart 提供号码的国家/地区及其代码。

GET/server5-countries
请求示例
curl "https://textverification.io/api/v1/users/server5-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

获取订购选项

返回某个国家/地区中某项服务可用的区号，以及它们带来的加价。

GET/server5-options
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/server5-options?serviceId=7d0f3b11&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "price": "0.12",
    "successRate": 61,
    "bestSuccess": {
      "price": "0.15",
      "successRate": 84
    },
    "areaCodes": {
      "surcharge": 20,
      "lines": [
        {
          "price": "0.17",
          "successRate": 84,
          "codes": [
            "212",
            "646"
          ]
        }
      ]
    }
  },
  "message": "Request Successful!",
  "success": true
}

订购号码

为某项服务订购一个 Smart 号码，并从余额中扣费。

POST/request-s5-service
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
areaCodesstring[]否要获取的区号，或配合 excludeAreaCodes 要避开的区号：列表或逗号分隔，最多 10 个。会增加价格。
excludeAreaCodesboolean否设为 true 时避开这些区号，而不是获取其中之一的号码。
prioritystring否"price"（默认）选择最低价格，或 "success" 选择最有可能收到验证码的线路。
quantitynumber否一次订购的号码数量，1 至 5。每个号码都是单独的订单。
phoneNumberstring否您以前用过的指定号码，含国家代码的数字，前提是该号码再次空闲。

数量大于 1 时，响应会列出所有已下的订单；如果实际订购数量较少，会说明数量及原因。

请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"7d0f3b11","areaCodes":["212"],"priority":"success"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "status": "reserved",
    "price": "0.14",
    "expiredIn": 1200
  },
  "message": "Request Successful!",
  "success": true
}

获取订单

返回订单及其状态；验证码到达后，一并返回验证码。

GET/number-details-s5
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/number-details-s5?orderId=AB12CD34" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.14",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

复用号码

在服务允许的情况下，再次订购同一号码以接收另一个验证码。

POST/reuse-s5-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reuse-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"AB12CD34"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "AB12CD34",
    "number": "12125550105",
    "serviceName": "Telegram",
    "country": "United States",
    "price": "0.14",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

取消号码

取消尚未收到验证码的号码，并将费用退回您的余额。

POST/reject-s5-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reject-s5-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"AB12CD34"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Plus

来自众多国家的号码，每项服务有多条线路：订购最便宜的、选择线路，或设定最高价格。

列出服务和价格

列出 Plus 的服务以及每项服务扣除折扣后的价格。

GET/server6-pricing
参数类型必填说明
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/server6-pricing?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "5b2c9e41",
      "serviceName": "WhatsApp",
      "price": "0.68"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

列出国家

列出 Plus 提供号码的国家/地区及其代码。

GET/server6-countries
请求示例
curl "https://textverification.io/api/v1/users/server6-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    },
    {
      "code": "gb",
      "name": "United Kingdom"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

列出线路和价格

列出某项服务在某个国家/地区的销售线路，从最便宜的开始，附上您在每条线路的价格及其成功率（如已有数据）。

GET/server6-options
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/server6-options?serviceId=5b2c9e41&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "price": "0.68",
    "lines": [
      {
        "lineId": "a91f03c2",
        "price": "0.68",
        "successRate": 92
      },
      {
        "lineId": "4e7d2b10",
        "price": "0.68",
        "successRate": null
      },
      {
        "lineId": "c03b5f77",
        "price": "1.08",
        "successRate": 97
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

订购号码

为某项服务订购一个 Plus 号码，并从余额中扣费。

POST/request-s6-service
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
lineIdstring否线路列表中的一条线路。留空则使用最便宜的线路。
maxPricenumber否您愿意支付的最高金额（美元）。高于此价格将被拒绝；未指定 lineId 时，可能使用不超过此价格的任一线路。

未指定 lineId 时使用最便宜的线路；如果该线路没有号码，则使用同价的其他线路。如果某条线路收不到某项服务的验证码，请拒绝该号码，并改用其他 lineId 下单。

请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"5b2c9e41","country":"us","maxPrice":0.7}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "0.68",
    "expiredIn": 1200,
    "lineId": "a91f03c2"
  },
  "message": "Request Successful!",
  "success": true
}

获取订单

返回订单及其状态；验证码到达后，一并返回验证码。

GET/number-details-s6
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/number-details-s6?orderId=230698" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "0.68",
    "lineId": "a91f03c2",
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

复用号码

在服务允许的情况下，再次订购同一号码以接收另一个验证码。

POST/reuse-s6-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reuse-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"230698"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "230698",
    "number": "15551230456",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "0.68",
    "lineId": "a91f03c2",
    "status": "reserved",
    "expiredIn": 600
  },
  "message": "Request Successful!",
  "success": true
}

取消号码

取消尚未收到验证码的号码，并将费用退回您的余额。

POST/reject-s6-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reject-s6-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"230698"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Express

用于快速接码的美国号码：为某项服务下单后，在号码有效的 5 分钟内通过订单详情或回调获取验证码。

列出服务和价格

列出 Express 的服务以及每项服务扣除折扣后的价格。

GET/server7-pricing
请求示例
curl "https://textverification.io/api/v1/users/server7-pricing" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "3e7a91c0",
      "serviceName": "WhatsApp",
      "price": "0.75",
      "multiplePrice": "1.13",
      "smsModes": [
        "single",
        "multiple"
      ]
    },
    {
      "serviceId": "8b2c40d1",
      "serviceName": "Telegram",
      "price": "0.50",
      "multiplePrice": null,
      "smsModes": [
        "single"
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

订购号码

为某项服务订购一个 Express 号码，并从余额中扣费。

POST/request-s7-service
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
smsModestring否"multiple" 表示号码有效期间（5 分钟）收到的每条短信都会在到达时送达，按该服务的 multiplePrice 计费。仅适用于 smsModes 包含 "multiple" 的服务。默认为 "single"；仅以多条短信方式出售的服务默认为 "multiple"。

Express 号码有效期为 5 分钟。如在此期间未收到验证码，订单将自动取消并退款。Express 号码不可重复使用。 当 smsMode 为 "multiple" 时，号码在 5 分钟内会持续接收验证码：每个新验证码都会再发送一次 s7_otp_received 回调，订单详情会列出所有验证码，最新的为 pin。

请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s7-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"3e7a91c0","smsMode":"multiple"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "9f2c41ab07d3e815",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "status": "reserved",
    "price": "1.13",
    "expiredIn": 300,
    "smsMode": "multiple"
  },
  "message": "Request Successful!",
  "success": true
}

获取订单

返回订单及其状态；验证码到达后，一并返回验证码。

GET/number-details-s7
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/number-details-s7?orderId=9f2c41ab07d3e815" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "9f2c41ab07d3e815",
    "number": "12125550142",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "1.13",
    "smsMode": "multiple",
    "codes": [
      {
        "code": "318204",
        "message": "Your code is 318204",
        "receivedAt": "2026-10-09 12:44:00"
      },
      {
        "code": "482910",
        "message": "Your code is 482910",
        "receivedAt": "2026-10-09 12:44:00"
      }
    ],
    "createdAt": "2026-10-09 12:44:00",
    "status": "completed",
    "message": "Your code is 482910",
    "pin": "482910"
  },
  "message": "Request Successful!",
  "success": true
}

取消号码

取消尚未收到验证码的号码，并将费用退回您的余额。

POST/reject-s7-service
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/reject-s7-service" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9f2c41ab07d3e815"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Pinpoint 租用

为一个服务保留美国号码 1 天至一年，支持续租和自动续租。

列出租用服务和价格

列出 Pinpoint 租用 的服务以及每种租用时长的价格。

GET/rental-services
请求示例
curl "https://textverification.io/api/v1/users/rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "rg5e1d20",
      "serviceName": "whatsapp"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

查询租用价格

返回某项服务每种租用时长的价格，可选择是否指定区号。

GET/rental-prices
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
areasstring否区号，用逗号分隔（最多 10 个）。会增加价格。

并非每项服务都提供所有时长：此接口会返回某项服务可租用的时长。

请求示例
curl "https://textverification.io/api/v1/users/rental-prices?serviceId=rg5e1d20" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "label": "oneDay",
      "days": 1,
      "price": "2.85"
    },
    {
      "label": "thirtyDay",
      "days": 30,
      "price": "7.20"
    },
    {
      "label": "oneYear",
      "days": 365,
      "price": "72.00"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

租用号码

通过 Pinpoint 租用 为某项服务租用号码，并从余额中扣除整个租期的费用。

POST/request-rental
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
durationstring是租用时长：oneDay、threeDay、sevenDay、fourteenDay、thirtyDay、ninetyDay 或 oneYear。
areasstring否区号，用逗号分隔（最多 10 个）。会增加价格。
autoRenewboolean否设为 true 时，在到期前几小时从余额中自动续租。
请求示例
curl -X POST "https://textverification.io/api/v1/users/request-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"rg5e1d20","duration":"thirtyDay","autoRenew":true}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "7.20",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "thirtyDay",
    "duration": 30,
    "renewals": 0
  },
  "message": "Request Successful!",
  "success": true
}

读取租用短信

返回该租用号码收到的短信，按时间从新到旧排列。

GET/rental-messages
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
page / limitnumber否页码和每页条数（最多 100）。
请求示例
curl "https://textverification.io/api/v1/users/rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

获取续租价格

列出使用中的租用可续租的时长及每种时长的价格。

GET/rental-renew-options
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "whatsapp",
    "periods": [
      {
        "period": "thirtyDay",
        "days": 30,
        "price": "7.20"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

续租

延长使用中的租用并从余额中扣费。未指定时长时，按原租用时长续租。

POST/renew-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
periodstring否续租时长（取值与 duration 相同）。省略时按原租用时长续租。
请求示例
curl -X POST "https://textverification.io/api/v1/users/renew-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"thirtyDay"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "14.40",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "thirtyDay",
    "duration": 30,
    "renewals": 1
  },
  "message": "Request Successful!",
  "success": true
}

开启或关闭自动续租

设置使用中的租用是否在到期前几小时从余额中自动续租。

POST/rental-auto-renew
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
enabledboolean是true 开启自动续租，false 关闭。
请求示例
curl -X POST "https://textverification.io/api/v1/users/rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":false}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": false
  },
  "message": "Request Successful!",
  "success": true
}

取消租用

取消仍可退款的租用（收到第一条短信之前），并将费用退回您的余额。

POST/release-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/release-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

Flex 租用

保留美国号码 1 至 30 天，支持自动续租和重新启用已过期号码。

列出租用服务和价格

列出 Flex 租用 的服务以及每种租用时长的价格。

GET/s3-rental-services
参数类型必填说明
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/s3-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "1f3aa214",
      "serviceName": "Amazon",
      "prices": [
        {
          "period": "1d",
          "days": 1,
          "price": "2.88"
        },
        {
          "period": "30d",
          "days": 30,
          "price": "5.76"
        }
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

列出国家

列出 Flex 租用 提供号码的国家/地区及其代码。

GET/s3-rental-countries
请求示例
curl "https://textverification.io/api/v1/users/s3-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

租用号码

通过 Flex 租用 为某项服务租用号码，并从余额中扣除整个租期的费用。

POST/request-s3-rental
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
periodstring是租用时长，来自服务列表，例如 "7d"。
areasstring否区号，用逗号分隔（最多 10 个）。会增加价格。
autoRenewboolean否设为 true 时，在到期前几小时从余额中自动续租。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"1f3aa214","period":"7d","autoRenew":true}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.20",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7,
    "renewPrice": "3.20"
  },
  "message": "Request Successful!",
  "success": true
}

获取租用详情

返回租用记录及其状态、到期日期和续租设置。

GET/s3-rental-details
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/s3-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "3.20",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

读取租用短信

返回该租用号码收到的短信，按时间从新到旧排列。

GET/s3-rental-messages
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
page / limitnumber否页码和每页条数（最多 100）。
请求示例
curl "https://textverification.io/api/v1/users/s3-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

续租

延长使用中的租用并从余额中扣费。未指定时长时，按原租用时长续租。

POST/renew-s3-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/renew-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "6.40",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

开启或关闭自动续租

设置使用中的租用是否在到期前几小时从余额中自动续租。

POST/s3-rental-auto-renew
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
enabledboolean是true 开启自动续租，false 关闭。
请求示例
curl -X POST "https://textverification.io/api/v1/users/s3-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":true}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

取消租用

取消仍可退款的租用（收到第一条短信之前），并将费用退回您的余额。

POST/cancel-s3-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/cancel-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

获取重新启用价格

列出已过期租用的号码可重新启用的时长及每种时长的价格。

GET/s3-rental-retake-options
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/s3-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "Amazon",
    "periods": [
      {
        "period": "7d",
        "days": 7,
        "price": "4.80"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

重新启用已过期号码

在号码仍空闲时，为同一服务重新租用已过期租用的号码。

POST/retake-s3-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
periodstring是租用时长，来自服务列表，例如 "7d"。
autoRenewboolean否设为 true 时，在到期前几小时从余额中自动续租。
请求示例
curl -X POST "https://textverification.io/api/v1/users/retake-s3-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"7d"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f9a811",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "4.80",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "7d",
    "duration": 7
  },
  "message": "Request Successful!",
  "success": true
}

Global 租用

在众多国家租用号码，可按任意可用时长续租，或设置自动续租。

列出租用服务和价格

列出 Global 租用 的服务以及每种租用时长的价格。

GET/s4-rental-services
参数类型必填说明
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/s4-rental-services" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "serviceId": "c41e7a02",
      "serviceName": "WhatsApp",
      "prices": [
        {
          "period": "1d",
          "days": 1,
          "price": "0.90"
        },
        {
          "period": "30d",
          "days": 30,
          "price": "9.60"
        }
      ]
    }
  ],
  "message": "Request Successful!",
  "success": true
}

列出国家

列出 Global 租用 提供号码的国家/地区及其代码。

GET/s4-rental-countries
请求示例
curl "https://textverification.io/api/v1/users/s4-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

租用号码

通过 Global 租用 为某项服务租用号码，并从余额中扣除整个租期的费用。

POST/request-s4-rental
参数类型必填说明
serviceIdstring是服务 ID，来自服务列表。
periodstring是租用时长，来自服务列表，例如 "7d"。
autoRenewboolean否设为 true 时，在到期前几小时从余额中自动续租。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serviceId":"c41e7a02","period":"30d","country":"us"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

获取租用详情

返回租用记录及其状态、到期日期和续租设置。

GET/s4-rental-details
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/s4-rental-details?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

读取租用短信

返回该租用号码收到的短信，按时间从新到旧排列。

GET/s4-rental-messages
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
page / limitnumber否页码和每页条数（最多 100）。
请求示例
curl "https://textverification.io/api/v1/users/s4-rental-messages?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "6702f1c4e2",
        "number": "12125550104",
        "service": "WhatsApp",
        "sender": "WhatsApp",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

获取续租价格

列出使用中的租用可续租的时长及每种时长的价格。

GET/s4-rental-renew-options
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/s4-rental-renew-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

续租

延长使用中的租用并从余额中扣费。未指定时长时，按原租用时长续租。

POST/renew-s4-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
periodstring否续租时长，来自续租价格。省略时按原租用时长续租。
请求示例
curl -X POST "https://textverification.io/api/v1/users/renew-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"30d"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "19.20",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

开启或关闭自动续租

设置使用中的租用是否在到期前几小时从余额中自动续租。

POST/s4-rental-auto-renew
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
enabledboolean是true 开启自动续租，false 关闭。
请求示例
curl -X POST "https://textverification.io/api/v1/users/s4-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","enabled":true}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

取消租用

取消仍可退款的租用（收到第一条短信之前），并将费用退回您的余额。

POST/cancel-s4-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/cancel-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

获取重新启用价格

列出已过期租用的号码可重新启用的时长及每种时长的价格。

GET/s4-rental-retake-options
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/s4-rental-retake-options?orderId=6702f1c4e2" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f1c4e2",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "periods": [
      {
        "period": "30d",
        "days": 30,
        "price": "9.60"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

重新启用已过期号码

在号码仍空闲时，为同一服务重新租用已过期租用的号码。

POST/retake-s4-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
periodstring是租用时长，来自服务列表，例如 "7d"。
autoRenewboolean否设为 true 时，在到期前几小时从余额中自动续租。
请求示例
curl -X POST "https://textverification.io/api/v1/users/retake-s4-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"6702f1c4e2","period":"30d"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "6702f9a811",
    "number": "12125550104",
    "serviceName": "WhatsApp",
    "country": "United States",
    "price": "9.60",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "period": "30d",
    "duration": 30
  },
  "message": "Request Successful!",
  "success": true
}

Plus 租用

按月租用某个国家/地区的号码，接收所有服务的短信；可续租，也可设为自动续租。

列出国家

列出 Plus 租用 提供号码的国家/地区及其代码。

GET/s6-rental-countries
请求示例
curl "https://textverification.io/api/v1/users/s6-rental-countries" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": [
    {
      "code": "ca",
      "name": "Canada"
    },
    {
      "code": "us",
      "name": "United States"
    }
  ],
  "message": "Request Successful!",
  "success": true
}

列出租用时长和价格

列出 Plus 租用 号码在某个国家/地区可租用的时长，以及每个时长的价格。

GET/s6-rental-plans
参数类型必填说明
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。
请求示例
curl "https://textverification.io/api/v1/users/s6-rental-plans?country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "country": {
      "code": "us",
      "name": "United States"
    },
    "plans": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      },
      {
        "period": "3m",
        "months": 3,
        "days": 90,
        "price": "21.00"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

租用号码

通过 Plus 租用 为某项服务租用号码，并从余额中扣除整个租期的费用。

POST/request-s6-rental
参数类型必填说明
periodstring是按月计的租用时长，取自时长列表："1m"、"2m"、"3m"、"6m" 或 "12m"。
autoRenewboolean否设为 true 时，在到期前几小时从余额中自动续租。
countrystring否来自国家列表的国家代码。省略时默认为美国（或第一个在售国家）。

Plus 租用号码不限于某一项服务：它可接收所有服务的短信。租用后 20 分钟内、收到第一条短信之前，可取消并退款。

请求示例
curl -X POST "https://textverification.io/api/v1/users/request-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"1m","country":"us","autoRenew":true}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "7.50",
    "status": "reserved",
    "canRefund": true,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

获取租用详情

返回租用记录及其状态、到期日期和续租设置。

GET/s6-rental-details
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/s6-rental-details?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "7.50",
    "status": "active",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

读取租用短信

返回该租用号码收到的短信，按时间从新到旧排列。

GET/s6-rental-messages
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
page / limitnumber否页码和每页条数（最多 100）。
请求示例
curl "https://textverification.io/api/v1/users/s6-rental-messages?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "messages": [
      {
        "id": "66f0a1",
        "orderId": "9c41e2b7",
        "number": "15143080170",
        "service": "Any service",
        "sender": "",
        "message": "Your WhatsApp code: 551-204",
        "pin": "551204",
        "timestamp": "2026-10-09 12:44:00"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  },
  "message": "Request Successful!",
  "success": true
}

获取续租价格

列出使用中的租用可续租的时长及每种时长的价格。

GET/s6-rental-renew-options
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/s6-rental-renew-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "periods": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      },
      {
        "period": "3m",
        "months": 3,
        "days": 90,
        "price": "21.00"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

续租

延长使用中的租用并从余额中扣费。未指定时长时，按原租用时长续租。

POST/renew-s6-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
periodstring否续租时长，取自续租价格，例如 "1m"。留空则按租用本身的时长续租。
请求示例
curl -X POST "https://textverification.io/api/v1/users/renew-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","period":"3m"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "28.50",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2027-02-09 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

开启或关闭自动续租

设置使用中的租用是否在到期前几小时从余额中自动续租。

POST/s6-rental-auto-renew
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
enabledboolean是true 开启自动续租，false 关闭。
请求示例
curl -X POST "https://textverification.io/api/v1/users/s6-rental-auto-renew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","enabled":true}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "autoRenew": true
  },
  "message": "Request Successful!",
  "success": true
}

取消租用

取消仍可退款的租用（收到第一条短信之前），并将费用退回您的余额。

POST/cancel-s6-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl -X POST "https://textverification.io/api/v1/users/cancel-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7"}'
响应示例
{
  "statusCode": 200,
  "data": null,
  "message": "Request Successful!",
  "success": true
}

获取重新启用价格

列出已过期租用的号码可重新启用的时长及每种时长的价格。

GET/s6-rental-retake-options
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
请求示例
curl "https://textverification.io/api/v1/users/s6-rental-retake-options?orderId=9c41e2b7" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "periods": [
      {
        "period": "1m",
        "months": 1,
        "days": 30,
        "price": "7.50"
      }
    ]
  },
  "message": "Request Successful!",
  "success": true
}

重新启用已过期号码

在号码仍空闲时，为同一服务重新租用已过期租用的号码。

POST/retake-s6-rental
参数类型必填说明
orderIdstring是订单 ID，下单时返回。
periodstring是按月计的租用时长，取自时长列表："1m"、"2m"、"3m"、"6m" 或 "12m"。
autoRenewboolean否设为 true 时，在到期前几小时从余额中自动续租。

重新激活会续租同一租用，orderId 和号码均保持不变。租用到期后的几天内均可操作。

请求示例
curl -X POST "https://textverification.io/api/v1/users/retake-s6-rental" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orderId":"9c41e2b7","period":"1m"}'
响应示例
{
  "statusCode": 200,
  "data": {
    "orderId": "9c41e2b7",
    "number": "15143080170",
    "serviceName": "Any service",
    "anyService": true,
    "country": "United States",
    "period": "1m",
    "months": 1,
    "duration": 30,
    "price": "15.00",
    "status": "reserved",
    "canRefund": false,
    "autoRenew": true,
    "purchased": "2026-10-09 12:44:00",
    "expires": "2026-11-08 12:44:00",
    "remainingTime": 2591940
  },
  "message": "Request Successful!",
  "success": true
}

回调

在账户设置中设置回调 URL。每当收到验证码或租用短信，我们都会以 HTTP POST 请求将其发送到该 URL，JSON 请求体包含 event 和 data。

  • 请在 5 秒内返回 2xx 状态码，以确认已收到。
  • 如果您的服务器未及时响应或返回其他状态码，我们会在 2 秒后重试，之后在 4 秒后再试一次：共尝试 3 次。
  • 同一事件可能会多次送达：请使用 orderId 忽略重复事件。

事件

事件触发时机
s1_otp_receivedPrime 号码收到验证码。
s1_win_premium_requestPrime 高级请求抢得号码。
s2_otp_receivedPinpoint 号码收到验证码。
s3_otp_receivedFlex 号码收到验证码。
s4_otp_receivedGlobal 号码收到验证码。
s5_otp_receivedSmart 号码收到验证码。
s6_otp_receivedPlus 号码收到验证码。
s7_otp_receivedExpress 号码收到验证码。
rental_otp_receivedPinpoint 租用 号码收到短信。
s3_rental_otp_receivedFlex 租用 号码收到短信。
s4_rental_otp_receivedGlobal 租用 号码收到短信。
s6_rental_otp_receivedPlus 租用 号码收到短信。

请求负载

data.orderId
验证码所属的订单。
data.timestamp
我们收到的时间（UTC）。
data.number
接收该消息的手机号码。
data.service
订购该号码时所选的服务。
data.message
完整的短信内容。
data.otp
从短信中提取的验证码。
回调示例
{
  "event": "s2_otp_received",
  "data": {
    "orderId": "lr_01K7ABC",
    "timestamp": "2026-10-09 12:44:00",
    "number": "12125550102",
    "service": "google",
    "message": "G-482910 is your Google verification code.",
    "otp": "482910"
  }
}

集成遇到问题？联系我们的团队。