API Verificador Masivo de Email: Gmail, Outlook, Yahoo y Más

Verifica qué direcciones de correo electrónico de tu lista subida están registradas en Gmail, Outlook, Yahoo, Mail.ru o iCloud. Usa task_type email_check y el mismo flujo de sondeo por lotes que otros verificadores.

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="email_check"'

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": 2000,
    "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": 2000,
    "success": 800,
    "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": 2000,
    "success": 2000,
    "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`, establecer en `email_check`

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 al crear la tarea

Campos del resultado

El archivo ZIP de resultados contiene archivos separados por proveedor de correo electrónico. Cada fila incluye:

Campo	Descripción
`Email`	Dirección de correo electrónico
`Active`	Si el correo electrónico está registrado en la plataforma (`true` / `false`)
`Provider`	Proveedor de correo electrónico detectado: `gmail`, `outlook`, `yahoo`, `mailru`, `icloud`, o `unsupported`

Proveedores compatibles

Proveedor	Subtarea `task_type`
Gmail	`email_gmail`
Outlook	`email_outlook`
Yahoo	`email_yahoo`
Mail.ru	`email_mailru`
iCloud	`email_icloud`

Tamaño mínimo del lote: 2,000 direcciones de correo electrónico por tarea.

Formato de respuesta

Campo	Descripción
`created_at`	Marca de tiempo de creación de la tarea
`updated_at`	Marca de tiempo de la última actualización del estado de la tarea
`task_id`	Identificador único de la tarea
`user_id`	ID de usuario
`status`	`pending` · `processing` · `exported` · `failed` (se reembolsa automáticamente)
`total`	Total de correos electrónicos enviados
`success`	Correos electrónicos verificados con éxito
`failure`	Filas que no se pudieron 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