19 - Consultar Dados de Lote de E-mail

cURL

cURL

curl --request POST \
  --url https://api.bmpdigital.moneyp.dev.br/Bureau/ConsultarEmailageLote \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --data '
{
  "webhookId": "<string>",
  "consulta": [
    {
      "email": "<string>",
      "primeiroNome": "<string>",
      "sobrenome": "<string>",
      "codPais": "<string>",
      "telefone": "<string>",
      "idRastreamento": "<string>",
      "idTransacao": "<string>",
      "endCobrancaRua": "<string>",
      "endCobrancaCidade": "<string>",
      "endCobrancaEstado": "<string>",
      "endCobrancaCEP": "<string>",
      "endCobrancaPais": "<string>",
      "endEntregaRua": "<string>",
      "endEntregaCidade": "<string>",
      "endEntregaEstado": "<string>",
      "endEntregaCEP": "<string>",
      "endEntregaPais": "<string>",
      "identificacaoDoCliente": "<string>",
      "idDispositivo": "<string>",
      "localizacaoDoServico": "<string>"
    }
  ]
}
'

200

{
  "msg": "<string>",
  "messages": [
    {
      "messageType": 1,
      "code": "<string>",
      "context": "<string>",
      "description": "<string>",
      "field": "<string>"
    }
  ],
  "hasError": true,
  "falha": true,
  "json": "<string>"
}

Este endpoint tem como objetivo realizar uma validação de risco utilizando o e-mail como campo obrigatório, juntamente com outras informações complementares, para obter o score de confiabilidade daquele e-mail.

O uso deste serviço é destinado ao processamento em lote.

Mostrar Exemplo de retorno completo

O exemplo de retorno, mostrado no lado direito desta tela, está resumido. Na linha "json": "<string>" o retorno do Bureau vem de forma serializada, sendo necessário deserializar para melhor visualização. Aqui está um exemplo do retorno deserializado que vem no campo "json":.

[
{
    \"userdefinedrecordid": " ",
    \"email": "[e-mail]",
    \"ipaddress": null,
    \"eName": " ",
    \"emailAge": " ",
    \"email_creation_days": " ",
    \"domainAge": "2017-05-27T00:00:00Z",
    \"domain_creation_days": "2923",
    \"firstVerificationDate  ": "2023-07-05T15:49:45Z",
    \"first_seen_days": "692",
    \"lastVerificationDate": "2025-05-28T14:13:55Z",
    \"status": "Verified",
    \"country": "BR",
    \"fraudRisk": "209 Low",
    \"EAScore": "209",
    \"EAReason": "Email Created at least 1.9 Years Ago",
    \"EAStatusID": "2",
    \"EAReasonID ": 14,
    \"EAAdviceID": "3",
    \"EAAdvice": "Lower Fraud Risk",
    \"EARiskBandID": "2",
    \"EARiskBand": "Fraud Score 101 to 300",
    \"dob": " ",
    \"gender": " ",
    \"location": " ",
    \"smfriends": " ",
    \"totalhits": "6",
    \"uniquehits": "1",
    \"imageurl": " ",
    \"emailExists": "Yes",
    \"domainExists": "Yes",
    \"company": " ",
    \"title": " ",
    \"billriskcountry": null,
    \"source_industry": " ",
    \"fraud_type": " ",
    \"fraudemail": null,
    \"fraudphone": null,
    \"fraudaddress": null,
    \"fraudpostal": null,
    \"fraudpostalXml": null,
    \"fraudzip": null,
    \"addressmatch": null,
    \"postalcity": null,
    \"postalregion": null,
    \"transidentifier": null,
    \"customeridentifiermatch": null,
    \"namematch": null,
    \"domainname": "fulltechpro.com.br",
    \"domaincompany": " ",
    \"domaincountryname": "Brazil",
    \"domaincategory": " ",
    \"domaincorporate": " ",
    \"domainrisklevel": "Moderate",
    \"domainrelevantinfo": "Valid  Domain from Brazil",
    \"domainrisklevelID": "3",
    \"domainrelevantinfoID": "508",
    \"domaincountrymatch": null,
    \"domainriskcountry": "No",
    \"smlinks": [],
    \"ip_risklevelid": null,
    \"ip_risklevel": null,
    \"ip_riskreasonid": null,
    \"ip_riskreason": null,
    \"ip_reputation": null,
    \"ip_anonymousdetected": null,
    \"ip_isp": null,
    \"ip_org": null,
    \"ip_userType": null,
    \"ip_netSpeedCell": null,
    \"ip_corporateProxy": null,
    \"ip_continentCode": null,
    \"ip_country": null,
    \"ip_countryCode": null,
    \"ip_countryconf": null,
    \"ip_region": null,
    \"ip_regionconf": null,
    \"ip_city": null,
    \"ip_cityconf": null,
    \"ip_postalcode": null,
    \"ip_postalconf": null,
    \"ip_callingcode": null,
    \"ip_metroCode": null,
    \"ip_riskscore": null,
    \"ip_latitude": null,
    \"ip_longitude": null,
    \"ip_map": null,
    \"ipcountrymatch": null,
    \"ipriskcountry": null,
    \"ipdistancekm": null,
    \"ipdistancekmXml": null,
    \"ipdistancemil": null,
    \"ipdistancemilXml": null,
    \"ipaccuracyradius": null,
    \"ipaccuracyradiuslXml": null,
    \"iptimezone": null,
    \"ipasnum": null,
    \"ipdomain": null,
    \"custphoneInbillingloc": null,
    \"shipforward": "No",
    \"citypostalmatch": null,
    \"shipcitypostalmatch": null,
    \"deviceIdRiskLevel": null,
    \"lastflaggedon": " ",
    \"phone_status": "Valid",
    \"phoneowner": null,
    \"phoneownertype": null,
    \"phonecarriertype": "invalid",
    \"phonecarriernetworkcode": null,
    \"phonecarriername": " ",
    \"phoneownermatch": null,
    \"ip_proxytype”: null,
    \"ip_proxydescription": null,
    \"issuerBank": null,
    \"issuerBrand": null,
    \"issuerCountry": null,
    \"cardCategory": null,
    \"cardType": null,
    \"overallDigitalIdentityScore": 46,
    \"overallDigitalIdentityScoreXml": "46",
    \"emailToIpConfidence": null,
    \"emailToIpConfidenceXml": null,
    \"emailToPhoneConfidence": 46,
    \"emailToPhoneConfidenceXml": "46",
    \"emailToBillAddressConfidence": null,
    \"emailToBillAddressConfidenceXml": null,
    \"emailToShipAddressConfidence": null,
    \"emailToShipAddressConfidenceXml": null,
    \"emailToFullNameConfidence": null,
    \"emailToFullNameConfidenceXml": null,
    \"emailToLastNameConfidence": null,
    \"emailToLastNameConfidenceXml": null,
    \"ipToPhoneConfidence": null,
    \"ipToPhoneConfidenceXml": null,
    \"ipToBillAddressConfidence": null,
    \"ipToBillAddressConfidenceXml": null,
    \"ipToShipAddressConfidence": null,
    \"ipToShipAddressConfidenceXml": null,
    \"ipToFullNameConfidence": null,
    \"ipToFullNameConfidenceXml": null,
    \"ipToLastNameConfidence": null,
    \"ipToLastNameConfidenceXml": null,
    \"phoneToBillAddressConfidence": null,
    \"phoneToBillAddressConfidenceXml": null,
    \"phoneToShipAddressConfidence": null,
    \"phoneToShipAddressConfidenceXml": null,
    \"phoneToFullNameConfidence": null,
    \"phoneToFullNameConfidenceXml": null,
    \"phoneToLastNameConfidence": null,
    \"phoneToLastNameConfidenceXml": null,
    \"billAddressToFullNameConfidence": null,
    \"billAddressToFullNameConfidenceXml": null,
    \"billAddressToLastNameConfidence": null,
    \"billAddressToLastNameConfidenceXml": null,
    \"shipAddressToBillAddressConfidence": null,
    \"shipAddressToBillAddressConfidenceXml": null,
    \"shipAddressToFullNameConfidence": null,
    \"shipAddressToFullNameConfidenceXml": null,
    \"shipAddressToLastNameConfidence": null,
    \"shipAddressToLastNameConfidenceXml": null,
    \"disDescription": "Moderate Confidence",
    \"standardizedBillingAddress": null,
    \"standardizedShippingAddress": null,
    \"custom1": null,
    \"custom2": null,
    \"custom3": null,
    \"custom4": null,
    \"custom5": null,
    \"custom6": null,
    \"custom7": null,
    \"trackingId": null,
    \"ipShipCountryMatch": null,
    \"ipShipDistanceMil": null,
    \"ipShipDistanceMilXml": null,
    \"ipShipDistanceKm": null,
    \"ipShipDistanceKmXml": null,
    \"correlationId": null,
    \"transAmount": null,
    \"transAmountXml": null,
},
{
    \"userdefinedrecordid": " ",
    \"email": "[e-mail]",
    \"ipaddress": null,
    \"eName": " ",
    \"emailAge": " ",
    \"email_creation_days": " ",
    \"domainAge": "2017-05-27T00:00:00Z",
    \"domain_creation_days": "2923",
    \"firstVerificationDate  ": "2023-07-05T15:49:45Z",
    \"first_seen_days": "692",
    \"lastVerificationDate": "2025-05-28T14:13:55Z",
    \"status": "Verified",
    \"country": "BR",
    \"fraudRisk": "209 Low",
    \"EAScore": "209",
    \"EAReason": "Email Created at least 1.9 Years Ago",
    \"EAStatusID": "2",
    \"EAReasonID ": 14,
    \"EAAdviceID": "3",
    \"EAAdvice": "Lower Fraud Risk",
    \"EARiskBandID": "2",
    \"EARiskBand": "Fraud Score 101 to 300",
    \"dob": " ",
    \"gender": " ",
    \"location": " ",
    \"smfriends": " ",
    \"totalhits": "6",
    \"uniquehits": "1",
    \"imageurl": " ",
    \"emailExists": "Yes",
    \"domainExists": "Yes",
    \"company": " ",
    \"title": " ",
    \"billriskcountry": null,
    \"source_industry": " ",
    \"fraud_type": " ",
    \"fraudemail": null,
    \"fraudphone": null,
    \"fraudaddress": null,
    \"fraudpostal": null,
    \"fraudpostalXml": null,
    \"fraudzip": null,
    \"addressmatch": null,
    \"postalcity": null,
    \"postalregion": null,
    \"transidentifier": null,
    \"customeridentifiermatch": null,
    \"namematch": null,
    \"domainname": "fulltechpro.com.br",
    \"domaincompany": " ",
    \"domaincountryname": "Brazil",
    \"domaincategory": " ",
    \"domaincorporate": " ",
    \"domainrisklevel": "Moderate",
    \"domainrelevantinfo": "Valid  Domain from Brazil",
    \"domainrisklevelID": "3",
    \"domainrelevantinfoID": "508",
    \"domaincountrymatch": null,
    \"domainriskcountry": "No",
    \"smlinks": [],
    \"ip_risklevelid": null,
    \"ip_risklevel": null,
    \"ip_riskreasonid": null,
    \"ip_riskreason": null,
    \"ip_reputation": null,
    \"ip_anonymousdetected": null,
    \"ip_isp": null,
    \"ip_org": null,
    \"ip_userType": null,
    \"ip_netSpeedCell": null,
    \"ip_corporateProxy": null,
    \"ip_continentCode": null,
    \"ip_country": null,
    \"ip_countryCode": null,
    \"ip_countryconf": null,
    \"ip_region": null,
    \"ip_regionconf": null,
    \"ip_city": null,
    \"ip_cityconf": null,
    \"ip_postalcode": null,
    \"ip_postalconf": null,
    \"ip_callingcode": null,
    \"ip_metroCode": null,
    \"ip_riskscore": null,
    \"ip_latitude": null,
    \"ip_longitude": null,
    \"ip_map": null,
    \"ipcountrymatch": null,
    \"ipriskcountry": null,
    \"ipdistancekm": null,
    \"ipdistancekmXml": null,
    \"ipdistancemil": null,
    \"ipdistancemilXml": null,
    \"ipaccuracyradius": null,
    \"ipaccuracyradiuslXml": null,
    \"iptimezone": null,
    \"ipasnum": null,
    \"ipdomain": null,
    \"custphoneInbillingloc": null,
    \"shipforward": "No",
    \"citypostalmatch": null,
    \"shipcitypostalmatch": null,
    \"deviceIdRiskLevel": null,
    \"lastflaggedon": " ",
    \"phone_status": "Valid",
    \"phoneowner": null,
    \"phoneownertype": null,
    \"phonecarriertype": "invalid",
    \"phonecarriernetworkcode": null,
    \"phonecarriername": " ",
    \"phoneownermatch": null,
    \"ip_proxytype”: null,
    \"ip_proxydescription": null,
    \"issuerBank": null,
    \"issuerBrand": null,
    \"issuerCountry": null,
    \"cardCategory": null,
    \"cardType": null,
    \"overallDigitalIdentityScore": 46,
    \"overallDigitalIdentityScoreXml": "46",
    \"emailToIpConfidence": null,
    \"emailToIpConfidenceXml": null,
    \"emailToPhoneConfidence": 46,
    \"emailToPhoneConfidenceXml": "46",
    \"emailToBillAddressConfidence": null,
    \"emailToBillAddressConfidenceXml": null,
    \"emailToShipAddressConfidence": null,
    \"emailToShipAddressConfidenceXml": null,
    \"emailToFullNameConfidence": null,
    \"emailToFullNameConfidenceXml": null,
    \"emailToLastNameConfidence": null,
    \"emailToLastNameConfidenceXml": null,
    \"ipToPhoneConfidence": null,
    \"ipToPhoneConfidenceXml": null,
    \"ipToBillAddressConfidence": null,
    \"ipToBillAddressConfidenceXml": null,
    \"ipToShipAddressConfidence": null,
    \"ipToShipAddressConfidenceXml": null,
    \"ipToFullNameConfidence": null,
    \"ipToFullNameConfidenceXml": null,
    \"ipToLastNameConfidence": null,
    \"ipToLastNameConfidenceXml": null,
    \"phoneToBillAddressConfidence": null,
    \"phoneToBillAddressConfidenceXml": null,
    \"phoneToShipAddressConfidence": null,
    \"phoneToShipAddressConfidenceXml": null,
    \"phoneToFullNameConfidence": null,
    \"phoneToFullNameConfidenceXml": null,
    \"phoneToLastNameConfidence": null,
    \"phoneToLastNameConfidenceXml": null,
    \"billAddressToFullNameConfidence": null,
    \"billAddressToFullNameConfidenceXml": null,
    \"billAddressToLastNameConfidence": null,
    \"billAddressToLastNameConfidenceXml": null,
    \"shipAddressToBillAddressConfidence": null,
    \"shipAddressToBillAddressConfidenceXml": null,
    \"shipAddressToFullNameConfidence": null,
    \"shipAddressToFullNameConfidenceXml": null,
    \"shipAddressToLastNameConfidence": null,
    \"shipAddressToLastNameConfidenceXml": null,
    \"disDescription": "Moderate Confidence",
    \"standardizedBillingAddress": null,
    \"standardizedShippingAddress": null,
    \"custom1": null,
    \"custom2": null,
    \"custom3": null,
    \"custom4": null,
    \"custom5": null,
    \"custom6": null,
    \"custom7": null,
    \"trackingId": null,
    \"ipShipCountryMatch": null,
    \"ipShipDistanceMil": null,
    \"ipShipDistanceMilXml": null,
    \"ipShipDistanceKm": null,
    \"ipShipDistanceKmXml": null,
    \"correlationId": null,
    \"transAmount": null,
    \"transAmountXml": null,
}
]

Tabelas

Mostrar Tabela de faixas de risco

Score de Risco	Nível	Descrição
1 - 100	Risco mais baixo	Nesta categoria, o endereço de e-mail normalmente existe há pelo menos quatro anos e estabeleceu um padrão de sinais positivos em todo o mundo. Os clientes com esse tipo de e-mail podem ser acelerados ou aprovados automaticamente em seu sistema.
101 - 300	Risco mínimo	O endereço de e-mail existe há um ou dois anos e tem outros sinais positivos associados a um endereço IP ou outro fator que é passado para a Emailage. Esses endereços representam muito pouco risco e podem ser aprovados, dependendo de outras circunstâncias que envolvem a transação ou cliente.
301 - 600	Risco neutro	Nenhum indicador negativo está associado às informações de entrada. No entanto, indicadores positivos não são suficientes para categorizar a transação como de menor risco.
601 - 799	Registro incorreto do e-mail	Preenchimento incorretamente, o endereço de email, tornando-o inválido ou incorreto.
800 - 899	Alto risco	A consulta é considerada arriscada devido a padrões de velocidade, sinais de endereços IP arriscados conhecidos ou detalhes da transação que refletem um histórico de suspeita de fraude na rede.
900 - 999	Risco muito alto	A transação é confirmada como fraudulenta ou associada a um alto nível de sinais de risco. Você deve revisar ou rejeitar manualmente

Mostrar Tabela de descrição dos campos da requisição

Variável	Descrição	Preenchimento esperado
email	O endereço de e-mail do cliente (Preenchimento obrigatório).	[e-mail]
PrimeiroNome	O primeiro nome do cliente.	Nome
Sobrenome	O sobrenome do cliente.	Sobrenome
Telefone	Informar o código do estado e complementar com o número de contato.	Celular: 11932244000/ Fixo: 1132244000
ddi	Informar o DDI do país, podendo ser repassado até três números.	DDI: 55 ou 123
IdentificacaoDoCliente	ID para identificação do cliente.	afd04b85-6b2e-494e-a87f15406928380a
EnderecoDeCobrancaRua	O endereço de cobrança do cliente.	123 Avenida paulista
EnderecoDeCobrancaCidade	A cidade de faturamento para o cliente.	Sao Paulo
EnderecoDeCobrancaEstado	O estado ou a região de cobrança do cliente.	Sao Paulo
EnderecoDeCobrancaCep	O CEP de cobrança do cliente.	39765000
EnderecoDeCobrancaPais	O país de cobrança do cliente. Valores possíveis: Nome completo do país. Código de país de duas letras.	Brasil ou BR
EnderecoDeEntregaRua	O endereço de entrega.	150 Pamplona
EnderecoDeEntregaCidade	A cidade do endereço de entrega.	Sao Paulo
EnderecoDeEntregaEstado	A região ou o estado do endereço de entrega.	Sao Paulo
EnderecoDeEntregaCep	O CEP do endereço de entrega.	1405000
EnderecoDeEntregaPais	O país de envio do cliente. Valores possíveis: Nome completo do país. Código de país de duas letras.	Brasil ou BR
IdTransacao	ID de registro definido pelo usuário. Esse parâmetro pode ser usado quando você deseja adicionar um identificador para uma consulta. Esse identificador é retornado com os resultados.	b5c78837-bb8d-4bdf-b44e0d1a9235b014
LocalizacaoDoServico	Esse valor se aplica a diferentes tipos de serviço: Viajar - Rota de voo. Hospitalidade - Localização do hotel. Emissão de ingressos - Local do evento. Tecnologia/Finanças/Comércio Eletrônico - A localização do serviço/canal/perfil final.	Exemplo: “Transporte do metro sentido centro”
IdDispositivo	ID do dispositivo do cliente, conforme definido pelo fabricante do dispositivo.	1653b405-5620-4f6f-a37df3867fce200c
IdRastreamento	Esse campo pode ser usado quando você deseja adicionar um identificador interno do sistema.

Autorizações

Authorization · string · header · obrigatório

Informe o token

Cabeçalhos

IdempotencyKey · string · obrigatório

Corpo

application/jsontext/jsonapplication/*+json

webhookId · string | null

consulta · object[] | null

Show child attributes

Resposta

200

text/plain

Success

msg · string | null

messages · object[] | null

Show child attributes

hasError · boolean

falha · boolean

json · string | null