Saltar para o conteúdo principal
GET
/
email
/
find
/
bulk
curl --request GET \
  --url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "3d4cb64e-i64d-41e8-a686-736751004a32",
    "status": "completed",
    "custom": "campaign_q2"
  },
  "stats": {
    "finished": 3,
    "requested": 3,
    "valid": 2,
    "credits_cost": {
      "initial": 3,
      "refunded": 1,
      "final": 2
    }
  },
  "results": [
    {
      "index": "0",
      "qualification": "valid",
      "email": "dwight.schrute@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Dwight",
        "lastname": "Schrute",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Dwight Schrute"
      },
      "custom": "lead_001"
    },
    {
      "index": "1",
      "qualification": "valid",
      "email": "jim.halpert@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Jim",
        "lastname": "Halpert",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Jim Halpert"
      },
      "custom": "lead_002"
    },
    {
      "index": "2",
      "qualification": "invalid",
      "email": null,
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Ryan Howard"
      },
      "custom": "lead_003"
    }
  ]
}
GET 
https://api.enrow.io/email/find/bulk?id={id}
Recupere todos os resultados de uma busca de e-mails em lote usando o ID do lote. Autentique cada requisição com sua chave de API no cabeçalho x-api-key. O ID do lote é o id retornado quando você inicia um trabalho com o endpoint Find Bulk Emails.
Usar um webhook permite que você dispense a chamada a este endpoint GET. Consulte How Webhooks Work.

​
Parâmetros de Consulta

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

​
Resposta

​
200 — Busca concluída

​
general
object
Metadados do lote
​
stats
object
Estatísticas do lote
​
results
array
Array de resultados da busca

​
200 — Busca ainda em andamento

Enquanto o lote está em execução, o endpoint GET retorna HTTP 200 com um corpo reduzido no formato { general: { id, status: "ongoing" }, stats: { finished, requested } }.
​
general
object
id e status: "ongoing"
​
stats
object
Contagens de finished e requested

​
Respostas de Erro

CodeMessage
400Could not retrieve bulk search results
Consulte Error handling para a lista completa de códigos de status e formatos de resposta. 
curl --request GET \
  --url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "general": {
    "id": "3d4cb64e-i64d-41e8-a686-736751004a32",
    "status": "completed",
    "custom": "campaign_q2"
  },
  "stats": {
    "finished": 3,
    "requested": 3,
    "valid": 2,
    "credits_cost": {
      "initial": 3,
      "refunded": 1,
      "final": 2
    }
  },
  "results": [
    {
      "index": "0",
      "qualification": "valid",
      "email": "dwight.schrute@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Dwight",
        "lastname": "Schrute",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Dwight Schrute"
      },
      "custom": "lead_001"
    },
    {
      "index": "1",
      "qualification": "valid",
      "email": "jim.halpert@dundermifflin.com",
      "info": {
        "domain": "dundermifflin.com",
        "firstname": "Jim",
        "lastname": "Halpert",
        "companyInfo": {
          "name": "Dunder Mifflin"
        }
      },
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Jim Halpert"
      },
      "custom": "lead_002"
    },
    {
      "index": "2",
      "qualification": "invalid",
      "email": null,
      "raw_params": {
        "company_domain": "dundermifflin.com",
        "fullname": "Ryan Howard"
      },
      "custom": "lead_003"
    }
  ]
}

​
Próximos passos

Encontrar e-mails em massa

Inicie um novo lote de até 5.000 buscas de e-mail.

Webhooks

Dispense o polling e seja notificado quando um lote for concluído.

Credits & billing

Veja como os créditos são cobrados e reembolsados por resultado.

Verificar e-mails em massa

Valide uma lista de endereços de e-mail em um único lote.