Listar lotes
GET
/email-validation-batches
curl --request GET \ "https://api.iporto.com.br/api/external/v1/email-validation-batches" \ --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", { 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', [ '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'headers = {'Authorization': 'Bearer ' + os.environ['IPORTO_API_KEY']}
resposta = requests.get(url, headers=headers)
print(resposta.json())Os lotes da conta, do mais recente para o mais antigo.
Authorizations
Seção intitulada “Authorizations”Parameters
Seção intitulada “Parameters”Query Parameters
Seção intitulada “Query Parameters”status
string
O andamento do lote: pending, extracting, validating, completed ou failed.
name
string
Início do nome do arquivo.
per_page
integer
Itens por página.
page
integer
A página, começando em 1.
Responses
Seção intitulada “Responses”A página de lotes.
Media typeapplication/json
object
object
string
data
Array<object>
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
meta
object
page
integer
per_page
integer
has_more
Há próxima página. Não existe total: contar a tabela a cada requisição é varredura num cliente com arquivo grande.
boolean
Example
{ "object": "list"}A chave não foi enviada, ou venceu.
Media typeapplication/json
object
error
string
Examplegenerated
{ "error": "example"}Um filtro de valor fechado recebeu valor inválido.
Media typeapplication/json
object
error
string
Examplegenerated
{ "error": "example"}