Submit File

POST/v1/detect/file

Upload a TXT or CSV file with one number per line, max 50 MB.

Parameters

Content-Type: multipart/form-data

Field	Type	Required	Description
product	string	Yes	Product slug
country	string	Yes	ISO country code
file	file	Yes	TXT or CSV file, one number per line, max 50 MB.

Response Example

{
  "mode": "async",
  "task_id": "qH5rZ7Lp3Wm9",
  "message": "File queued (10000 numbers). Poll GET /api/v1/tasks/qH5rZ7Lp3Wm9 for progress.",
  "summary": {
    "total": 10000,
    "cost_deducted": 1.000000
  }
}