HTX API de Verificación de Email: Verificación Masiva de Correos Electrónicos

Verifica si los correos electrónicos de tu archivo están registrados con HTX. Utiliza task_type htx_email y el mismo flujo de sondeo por lotes que otros servicios basados en correo electrónico.

Ejemplo para subir el archivo de detección:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./emails.txt"' \
--form 'task_type="htx_email"'

Ejemplo para consultar el estado de la tarea:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Respuesta cuando la carga del archivo fue exitosa:

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Respuesta para el estado de procesamiento:

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Respuesta cuando la tarea está completada (incluye la URL de descarga):

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL de solicitud para subir archivo

POST https://api.checknumber.ai/v1/tasks

Parámetros de solicitud para subir archivo

Parámetro	Descripción
file	file, una dirección de correo electrónico por línea
task_type	string, establece a htx_email

URL de solicitud para consultar estado

POST https://api.checknumber.ai/v1/gettasks

Parámetros de solicitud para consultar estado

Parámetro	Descripción
task_id	string, ID de tarea devuelto desde la creación de la tarea

Campos del resultado

Campo	Descripción
Email	Dirección de correo electrónico
htx	Si el correo electrónico está registrado en HTX (yes / no estilo; etiquetas por exportación)

Formato de respuesta

Campo	Descripción
created_at	Marca de tiempo cuando se creó la tarea
updated_at	Marca de tiempo de la última actualización de estado de tarea
task_id	Identificador único de tarea
user_id	ID de usuario
status	pending · processing · exported · failed (se reembolsa automáticamente)
total	Total de correos electrónicos procesados
success	Correos electrónicos verificados exitosamente
failure	Filas que fallaron al procesar
result_url	URL de descarga cuando status es exported
actual_amount	(Opcional) Importe realmente cobrado, disponible cuando la tarea se liquida
estimated_amount	(Respuesta de creación) Importe estimado de la tarea; el cobro final se liquida al completarse

Códigos de estado

Estado	Descripción
200	free, Solicitud correcta (p. ej., consulta de estado)
202	charge, Tarea creada correctamente; se deduce el importe estimado
400	free, Solicitud incorrecta: parámetros o formato de archivo no válidos, tipo de tarea no admitido o entradas válidas por debajo del lote mínimo
401	free, Clave API ausente o no válida
402	free, Saldo insuficiente
404	free, Tarea no encontrada
413	free, Archivo subido demasiado grande
500	free, Error interno del servidor; inténtelo más tarde