Submit Numbers

POST/v1/detect

Submit an array of phone numbers for detection. Processed asynchronously. Cost is pre-deducted; unchecked numbers are automatically refunded.

Note

1,000 to 2,000,000 numbers per request. Include country code, e.g. +8613800138000.

Parameters

Field	Type	Required	Description
product	string	Yes	Product slug. See the product list.
country	string	Yes	ISO 3166-1 alpha-2 country code, for example CN or US.
phones	array	Yes	Array of phone numbers, 1,000 to 2,000,000.

Response Example

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "message": "Task queued. Poll GET /api/v1/tasks/xKj9aP3qLm7v for progress.",
  "summary": {
    "total": 5000,
    "cost_deducted": 0.500000
  }
}