Flujo Típico
Envía un array de números para detección. Procesado de forma asíncrona.
Endpoints de un vistazo
Sección titulada «Endpoints de un vistazo»| Endpoints | Descripción |
|---|---|
GET /v1/balance | Devuelve el saldo USD actual. |
POST /v1/detect | Envía un array de números para detección. Procesado de forma asíncrona. |
POST /v1/detect/file | Sube un archivo TXT/CSV con un número por línea, máx 50 MB. |
GET /v1/tasks/{token} | Consulta cada 3–5 segundos hasta completed o failed. |
GET /v1/tasks/{token}/result | Obtén el enlace de descarga del resultado. Los archivos se conservan 7 días por defecto (configurable mediante result_retention_days). |
GET /v1/tasks/{token}/download | Descarga el archivo de resultados ya finalizado como adjunto. Puedes seguir el download_url del endpoint de resultados o llamar a este endpoint con el mismo token de tarea. |
HTTP 202 Accepted
Antes de enviar
Sección titulada «Antes de enviar»- El envío debe cumplir el mínimo del producto seleccionado —500, 1,000 o 2,000 según el producto, y se muestra en la lista de productos masivos— y mantenerse por debajo del máximo de la plataforma de 2,000,000. Un envío por debajo del mínimo se rechaza como
too_few_numbers. - Productos de teléfono: el código ISO 3166-1 alpha-2, por ejemplo
CNoUS. Productos de correo electrónico: omite este campo por completo. — Códigos de país