Saltar para o conteúdo principal
GET
/
email
/
verify
/
bulk
curl --request GET \
  --url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
  --header 'x-api-key: YOUR_API_KEY'
{
  "general": {
    "id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
    "status": "completed"
  },
  "results": [
    {
      "email": "pam.beesly@dundermifflin.com",
      "index": "195f87c6-376e-4eca-9861-f92935413b0c",
      "qualification": "valid"
    },
    {
      "email": "angela.martin@dundermifflin.com",
      "index": "662784ae-3722-47af-b056-7554e013f73b",
      "qualification": "valid"
    }
  ],
  "stats": {
    "credits_cost": 0.5,
    "requested": 2,
    "valid": 2
  }
}
GET
https://api.enrow.io/email/verify/bulk?id={id}
Recupere todos os resultados de uma verificação de e-mails em massa usando o ID do lote. Autentique cada requisição com sua chave de API no cabeçalho x-api-key. Para iniciar um lote primeiro, use o endpoint Verify Bulk Emails.
O uso de um webhook permite que você dispense a chamada a este endpoint GET. Consulte Como os Webhooks Funcionam.

Parâmetros de Consulta

id
string
obrigatório
O id retornado pela requisição POST

Resposta

200 — Verificação concluída

general
object
Metadados do lote
stats
object
Estatísticas do lote
results
array
Array de resultados de verificação

200 — Verificação ainda em andamento

Enquanto o lote ainda estiver em execução, o endpoint retorna HTTP 200 com o estado do lote em vez dos resultados completos.
general
object
Metadados do lote
stats
object
Progresso do lote

Respostas de Erro

CodeMessage
400Could not retrieve bulk verification results
Consulte Tratamento de erros para a lista completa de códigos de status e formatos de resposta.
curl --request GET \
  --url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
  --header 'x-api-key: YOUR_API_KEY'
{
  "general": {
    "id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
    "status": "completed"
  },
  "results": [
    {
      "email": "pam.beesly@dundermifflin.com",
      "index": "195f87c6-376e-4eca-9861-f92935413b0c",
      "qualification": "valid"
    },
    {
      "email": "angela.martin@dundermifflin.com",
      "index": "662784ae-3722-47af-b056-7554e013f73b",
      "qualification": "valid"
    }
  ],
  "stats": {
    "credits_cost": 0.5,
    "requested": 2,
    "valid": 2
  }
}

Próximos passos

Verificar e-mails em massa

Inicie uma verificação em lote e receba de volta o id do lote.

Verificar um único e-mail

Verifique se um endereço de e-mail é válido e entregável.

Webhooks

Seja notificado automaticamente quando um lote for concluído, em vez de consultar repetidamente.

Créditos e cobrança

Veja como os créditos são consumidos para cada endpoint.