> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# 19 - Consultar Dados de Lote de E-mail
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.
O exemplo de retorno, mostrado no lado direito desta tela, está resumido. Na linha `"json": ""` 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":`.
```json theme={null}
[
{
\"userdefinedrecordid": " ",
\"email": "jose@pro.com.br",
\"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": "jose@pro.com.br",
\"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
| 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 |
| Variável | Descrição | Preenchimento esperado |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| `email` | O endereço de e-mail do cliente (Preenchimento obrigatório). | [email-de-exemplo@mail.com](mailto:email-de-exemplo@mail.com) |
| `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. | |
## OpenAPI
````yaml post /Bureau/ConsultarEmailageLote
openapi: 3.0.1
info:
title: BMPDigitalCore.ApiExterna.Bureau.API
version: '1.0'
servers:
- url: https://api.bmpdigital.moneyp.dev.br/
description: Localhost
security:
- Bearer: []
paths:
/Bureau/ConsultarEmailageLote:
post:
tags:
- BureauAsync
parameters:
- name: IdempotencyKey
in: header
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ConsultaEmailageLoteCommand'
text/json:
schema:
$ref: '#/components/schemas/ConsultaEmailageLoteCommand'
application/*+json:
schema:
$ref: '#/components/schemas/ConsultaEmailageLoteCommand'
responses:
'200':
description: Success
content:
text/plain:
schema:
$ref: '#/components/schemas/ConsultaEmailageResponse'
application/json:
schema:
$ref: '#/components/schemas/ConsultaEmailageResponse'
text/json:
schema:
$ref: '#/components/schemas/ConsultaEmailageResponse'
'400':
description: Bad Request
content:
text/plain:
schema:
$ref: '#/components/schemas/ConsultaEmailageResponse'
application/json:
schema:
$ref: '#/components/schemas/ConsultaEmailageResponse'
text/json:
schema:
$ref: '#/components/schemas/ConsultaEmailageResponse'
components:
schemas:
ConsultaEmailageLoteCommand:
type: object
properties:
webhookId:
type: string
nullable: true
consulta:
type: array
items:
$ref: '#/components/schemas/EmailAgeLoteItem'
nullable: true
additionalProperties: false
ConsultaEmailageResponse:
type: object
properties:
msg:
type: string
nullable: true
result:
type: boolean
writeOnly: true
messages:
type: array
items:
$ref: '#/components/schemas/Message'
nullable: true
hasError:
type: boolean
falha:
type: boolean
json:
type: string
nullable: true
additionalProperties: false
EmailAgeLoteItem:
type: object
properties:
email:
type: string
nullable: true
primeiroNome:
type: string
nullable: true
sobrenome:
type: string
nullable: true
codPais:
type: string
nullable: true
telefone:
type: string
nullable: true
idRastreamento:
type: string
nullable: true
idTransacao:
type: string
nullable: true
endCobrancaRua:
type: string
nullable: true
endCobrancaCidade:
type: string
nullable: true
endCobrancaEstado:
type: string
nullable: true
endCobrancaCEP:
type: string
nullable: true
endCobrancaPais:
type: string
nullable: true
endEntregaRua:
type: string
nullable: true
endEntregaCidade:
type: string
nullable: true
endEntregaEstado:
type: string
nullable: true
endEntregaCEP:
type: string
nullable: true
endEntregaPais:
type: string
nullable: true
identificacaoDoCliente:
type: string
nullable: true
idDispositivo:
type: string
nullable: true
localizacaoDoServico:
type: string
nullable: true
additionalProperties: false
Message:
type: object
properties:
messageType:
$ref: '#/components/schemas/ErrorType'
code:
type: string
nullable: true
context:
type: string
nullable: true
description:
type: string
nullable: true
field:
type: string
nullable: true
additionalProperties: false
ErrorType:
enum:
- 1
- 2
- 3
type: integer
format: int32
securitySchemes:
Bearer:
type: apiKey
description: Informe o token
name: Authorization
in: header
````