Listar os e-mails de um lote
curl --request GET \ "https://api.iporto.com.br/api/external/v1/email-validation-batches/01K7Z6M2S4P8QR3VT9XWYB0CDE/validations" \ --header "Authorization: Bearer $IPORTO_API_KEY" \ --header "Accept: application/json"const resposta = await fetch("https://api.iporto.com.br/api/external/v1/email-validation-batches/01K7Z6M2S4P8QR3VT9XWYB0CDE/validations", { method: "GET", headers: { Authorization: `Bearer ${process.env.IPORTO_API_KEY}`, Accept: "application/json", },});
console.log(await resposta.json());$client = new \GuzzleHttp\Client();
$resposta = $client->get('https://api.iporto.com.br/api/external/v1/email-validation-batches/01K7Z6M2S4P8QR3VT9XWYB0CDE/validations', [ 'headers' => [ 'Authorization' => 'Bearer '.getenv('IPORTO_API_KEY'), 'Accept' => 'application/json', ],]);
print_r(json_decode((string) $resposta->getBody(), true));import osimport requests
url = 'https://api.iporto.com.br/api/external/v1/email-validation-batches/01K7Z6M2S4P8QR3VT9XWYB0CDE/validations'headers = {'Authorization': 'Bearer ' + os.environ['IPORTO_API_KEY']}
resposta = requests.get(url, headers=headers)
print(resposta.json())Os itens do lote, na ordem do arquivo — é como o cliente leu a lista dele.
⚠️ Os itens expiram; os totais do lote permanecem. Ver a retenção na página de referência.
Authorizations
Seção intitulada “Authorizations”Parameters
Seção intitulada “Parameters”Path Parameters
Seção intitulada “Path Parameters”O identificador do lote.
Query Parameters
Seção intitulada “Query Parameters”O andamento do item: pending, completed, failed ou insufficient_credits.
O veredito do motor: deliverable, risky, undeliverable ou unknown.
Se o endereço existe: true, false ou unknown.
Itens por página.
A página, começando em 1.
Responses
Seção intitulada “Responses”A página de itens.
object
O mesmo objeto que a tela do Validador consome. ⚠️ Os sinalizadores de result são TRI-ESTADO: true, false ou null — e null significa que o motor não soube, nunca “não”.
object
object
object
object
object
object
object
Há próxima página. Não existe total: contar a tabela a cada requisição é varredura num cliente com arquivo grande.
Example
{ "object": "list"}A chave não foi enviada, ou venceu.
object
Examplegenerated
{ "error": "example"}O lote não existe ou é de outra conta.
object
Examplegenerated
{ "error": "example"}Um filtro de valor fechado recebeu valor inválido.
object
Examplegenerated
{ "error": "example"}