VALIDADOR DE CORREO ELECTRÓNICO POR LOTES - EN TIEMPO REAL (V2)

Consulte los límites de tráfico de la API. Si desea realizar validaciones de correo electrónico individuales, por favor utilice nuestro punto final de validación de correo electrónico único.

Si desea cargar archivos con correos electrónicos superiores a 200 a la vez sin restricciones de limitación de tráfico, por favor utilice nuestros ,Puntos Finales de Administración de Archivos Masivos, que también incluyen anti-greylisting como beneficio añadido.

Este punto final puede tardar hasta 70 segundos en devolver los resultados de todo el lote. Actualmente no tenemos un SDK para este punto final, pero los SDK están disponibles para nuestros otros puntos finales.

- POST /V2/VALIDATEBATCH

API URL:

api.zerobounce.net/v2/validatebatch
api-us.zerobounce.net/v2/validatebatch
api-eu.zerobounce.net/v2/validatebatch

A continuación, encontrará las instrucciones sobre cómo usar nuestra API, es muy fácil de usar y requiere SSL. La API requiere que tenga un saldo de crédito activo y nunca consumirá un crédito por cualquier resultado desconocido.

Parámetros URL

Parámetro
Descripció

api_key
Su clave API
email_batch
[[Matriz de objetos], formato: {"dirección correo": "válido@ejemplo.com", "dirección_ip": "1.1.1.1"}
tiempo de espera
La duración (10 - 120 segundos) permitida para la validación. Si se cumple, la API devolverá desconocido/en lista gris. (parámetro opcional)
activity_data
[true/false] Si se establece en ‘true’, la información de Activity Data se añadirá al resultado de la validación. (parámetro opcional)
Más información sobre Activity Data.
verify_plus
[true/false] Si se establece en ‘true’, se utilizará el método de validación Verify+ para obtener el resultado de la validación. Esto anula la configuración de la cuenta con respecto a Verify+. (parámetro opcional)
Más información sobre Verify+.

SOLICITUD DE EJEMPLO DE PUBLICACIÓN


    {
      "api_key":"Your API Key",
          "email_batch":[
              {"email_address": "valid@example.com","ip_address": "1.1.1.1"},
              {"email_address": "invalid@example.com","ip_address": "1.1.1.1"},
              {"email_address": "disposable@example.com","ip_address": null}
          ],
      "activity_data" : true,
      "verify_plus": true
  }

PARA USAR ESTE PUNTO FINAL, USE LOS EJEMPLOS DE CÓDIGO A CONTINUACIÓN PARA EL LENGUAJE DESEADO:

Respuesta exitosa


    {
      "email_batch": [
          {
              "address": "john.doe@zerobounce.net",
              "status": "valid",
              "sub_status": "",
              "free_email": false,
              "catchall_domain": true,
              "did_you_mean": null,
              "account": "johndoe",
              "domain": "zerobounce.net",
              "domain_age_days": "3431",
              "active_in_days": "30",
              "active_first_seen": "2026-02-25",
              "smtp_provider": "g-suite",
              "mx_found": "true",
              "mx_record": "aspmx.l.google.com",
              "firstname": "dan",
              "lastname": "cotet",
              "gender": "male",
              "country": null,
              "region": null,
              "city": null,
              "zipcode": null,
              "processed_at": "2026-06-18 07:05:00.033"
          },
          {
              "address": "invalid@example.com",
              "status": "invalid",
              "sub_status": "mailbox_not_found",
              "free_email": false,
              "did_you_mean": null,
              "account": null,
              "domain": null,
              "domain_age_days": "9692",
              "active_in_days": "365",
              "active_first_seen": "2026-02-25",
              "smtp_provider": "example",
              "mx_found": "true",
              "mx_record": "mx.example.com",
              "catchall_domain": false,
              "firstname": "zero",
              "lastname": "bounce",
              "gender": "male",
              "country": null,
              "region": null,
              "city": null,
              "zipcode": null,
              "processed_at": "2020-09-17 17:43:11.830"
          },
          {
              "address": "disposable@example.com",
              "status": "do_not_mail",
              "sub_status": "disposable",
              "free_email": false,
              "did_you_mean": null,
              "account": null,
              "domain": null,
              "domain_age_days": "9692",
              "active_in_days": "365",
              "active_first_seen": "2026-02-25",
              "smtp_provider": "example",
              "mx_found": "true",
              "mx_record": "mx.example.com",
              "catchall_domain": false,
              "firstname": "zero",
              "lastname": "bounce",
              "gender": "male",
              "country": null,
              "region": null,
              "city": null,
              "zipcode": null,
              "processed_at": "2020-09-17 17:43:11.830"
          }
      ],
      "errors": []
  }

Respuesta de error


    {
      "email_batch": [],
      "errors": [
          {
              "error": "Invalid API Key or your account ran out of credits",
              "email_address": "all"
          }
      ]
    }

LA API DEVOLVERÁ UN OBJETO JSON CON 2 VALORES DE MATRIZ, "EMAIL_BATCH" Y "ERRORS" USANDO EL MÉTODO "BATCHVALIDATE".

La propiedad email_batch será una matriz de resultados validados y la matriz de errores será una matriz de errores encontrados durante la validación del lote, si los hubiera.

Propiedades JSON

Propiedades
Descripció

email_batch
[Matriz] Una matriz de correos electrónicos validados
errors
[Matriz] Una matriz de errores incrustados, si los hay

Propiedades lote_correo

Propiedades
Descripció

address
La dirección de correo electrónico que está validando.
status
[valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail]
sub_status
[alternate, antispam_system, greylisted, mail_server_temporary_error, forcible_disconnect, mail_server_did_not_respond, timeout_exceeded, failed_smtp_connection, mailbox_quota_exceeded, exception_occurred, possible_trap, role_based, global_suppression, mailbox_not_found, no_dns_entries, failed_syntax_check, possible_typo, unroutable_ip_address, leading_period_removed, does_not_accept_mail, alias_address, role_based_catch_all, disposable, toxic]
account
La parte de la dirección de correo electrónico antes del símbolo "@".
domain
La parte de la dirección de correo electrónico después del símbolo "@".
did_you_mean
Solución sugerente para un error tipográfico en el correo electrónico
domain_age_days
Antigüedad del dominio de correo electrónico en días o [nulo].
active_in_days
Fecha de última actividad menor que [30/60/90/180/365/365+]
active_first_seen
La primera fecha en la que detectamos una señal (actividad) para este correo electrónico.
free_email
[verdadero / falso] Si el correo electrónico proviene de un proveedor gratuito.
mx_found
[verdadero / falso] ¿El dominio tiene un registro MX?
mx_record
El registro MX preferido del dominio
smtp_provider
El proveedor SMTP del correo electrónico o [nulo] [BETA].
catchall_domain
[verdadero/falso o nulo] ¿El dominio es de tipo catch-all (el servidor de correo del dominio responde como válido a cualquier verificación SMTP y enviar un correo a una dirección inválida podría no rebotar)?
firstname
El nombre del propietario del correo electrónico cuando esté disponible o [nulo].
lastname
El apellido del propietario del correo electrónico cuando esté disponible o [nulo].
gender
El sexo del propietario del correo electrónico cuando esté disponible o [nulo].
city
La ciudad de la IP transmitida o [nulo]
region
La región / estado de la IP transmitida o [nulo]
zipcode
El código postal de la IP transmitida o [nulo]
country
El país de la PI transmitido o [nulo]
processed_at
La hora UTC en que se validó el correo electrónico.