Pular para o conteúdo

Listar verificações

GET
/email-validations
curl --request GET \
"https://api.iporto.com.br/api/external/v1/email-validations" \
--header "Authorization: Bearer $IPORTO_API_KEY" \
--header "Accept: application/json"

As verificações da conta, da mais recente para a mais antiga.

⚠️ A resposta não traz o total. Use meta.has_more para saber se há próxima página.

batch_id
string

Só as verificações de um lote.

email
string

O endereço exato. A comparação ignora maiúsculas.

status
string

O andamento do item: pending, completed, failed ou insufficient_credits.

send_status
string

O veredito do motor: deliverable, risky, undeliverable ou unknown.

valid
string

Se o endereço existe: true, false ou unknown — ver o aviso sobre o terceiro estado.

per_page
integer
default: 25 >= 1 <= 100

Itens por página.

page
integer
default: 1 >= 1

A página, começando em 1.

A página de verificações.

Media typeapplication/json
object
object
string
Allowed value: list
data
Array<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
string
nullable
id
string
nullable
batch_id
string
nullable
email
string
nullable
status
string
nullable
send
object
status
string
nullable
label
string
nullable
reasons
Array
result
object
valid
boolean
disposable
boolean
gibberish
boolean
typing_error
boolean
trap
boolean
abandoned
boolean
free
boolean
role
boolean
name
boolean
bank
boolean
gov
boolean
catch_all
boolean
domain
object
name
string
nullable
mx
string
nullable
diagnostic
object
smtp_response
string
nullable
line
object
number
integer
content
string
nullable
credits_charged
integer
checked_at
string
nullable
created_at
string
nullable
expires_at
string
nullable
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"
}