Obter lote
GET
/email-validation-batches/{id}
curl --request GET \ "https://api.iporto.com.br/api/external/v1/email-validation-batches/01K7Z6M2S4P8QR3VT9XWYB0CDE" \ --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", { 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', [ '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'headers = {'Authorization': 'Bearer ' + os.environ['IPORTO_API_KEY']}
resposta = requests.get(url, headers=headers)
print(resposta.json())Um lote, com os contadores e o progress.
É este o endpoint do acompanhamento: consulte até status virar completed ou failed.
Authorizations
Seção intitulada “Authorizations”Parameters
Seção intitulada “Parameters”Path Parameters
Seção intitulada “Path Parameters”id
required
string
O identificador do lote.
Responses
Seção intitulada “Responses”O lote.
Media typeapplication/json
Um lote de verificação. totals conta linhas e andamento; results conta o que o motor achou, e pode trazer null em qualquer campo — nulo é “não sabemos”.
object
object
string
id
string
name
string
source
string
origin
string
status
string
progress
integer
totals
object
lines
integer
emails
integer
duplicated
integer
pending
integer
completed
integer
failed
integer
insufficient_credits
integer
results
object
valid
integer
invalid
integer
unknown
integer
deliverable
integer
risky
integer
undeliverable
integer
unverified
integer
disposable
integer
gibberish
integer
typing_error
integer
trap
integer
abandoned
integer
free
integer
role
integer
name
integer
bank
integer
gov
integer
catch_all
integer
credits_charged
integer
file
object
size_bytes
integer
mime_type
string
error
created_at
string
started_at
string
completed_at
string
expires_at
string
items_pruned_at
Examplegenerated
{ "object": "example", "id": "example", "name": "example", "source": "example", "origin": "example", "status": "example", "progress": 1, "totals": { "lines": 1, "emails": 1, "duplicated": 1, "pending": 1, "completed": 1, "failed": 1, "insufficient_credits": 1 }, "results": { "valid": 1, "invalid": 1, "unknown": 1, "deliverable": 1, "risky": 1, "undeliverable": 1, "unverified": 1, "disposable": 1, "gibberish": 1, "typing_error": 1, "trap": 1, "abandoned": 1, "free": 1, "role": 1, "name": 1, "bank": 1, "gov": 1, "catch_all": 1 }, "credits_charged": 1, "file": { "size_bytes": 1, "mime_type": "example" }, "error": "example", "created_at": "example", "started_at": "example", "completed_at": "example", "expires_at": "example", "items_pruned_at": "example"}A chave não foi enviada, ou venceu.
Media typeapplication/json
object
error
string
Examplegenerated
{ "error": "example"}Não existe ou é de outra conta.
Media typeapplication/json
object
error
string
Examplegenerated
{ "error": "example"}