Skip to navigation
API Reference8. Antifraude e Validações8.1 Validação Cadastral e Vínculo

Proprietário Telefone Operadora

Esta API fornece informações associadas a um número de telefone, incluindo dados da operadora, localização, tipo de linha, bloqueios, estrutura do número e dados do possível titular. É útil para validação de contato, enriquecimento de base de dados e análises antifraude.

Indicada para validação de contato em onboarding digital, enriquecimento de base de dados com informações da operadora, detecção de linhas bloqueadas, verificação de titularidade de telefone e análises antifraude.

TABELA DE CAMPOS DE REQUISIÇÃO

CampoDescriçãoFormatoObrigatório
IdConsultaIdentificador da consulta. Valor fixo: 492.stringSim
TelefoneNúmero de telefone no formato 55DDD999999999.stringSim

TABELA DE CAMPOS DE RETORNO

CampoDescriçãoFormato
CONSULTA.CODIGORESPOSTACódigo interno de resposta gerado pela Credify.string
CONSULTA.DATAHORAData e hora da consulta no formato DD/MM/AAAA HH:MM:SS.string
CONSULTA.LOGONIdentificador do usuário que realizou a consulta.string
CONSULTA.IDCONSULTAIdentificador da consulta enviado na requisição.string
RESPOSTA.CODIGOCódigo de status da resposta (1 = sucesso, 2 = não encontrado, 3 = erro).string
CampoDescriçãoFormato
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.PHONE_TYPE.CODECódigo do tipo de telefone.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.PHONE_TYPE.DESCRIPTIONDescrição do tipo de telefone (ex.: MOBILE, LANDLINE).string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.BLOCKLISTING.BLOCKEDIndica se o número está bloqueado (TRUE / FALSE).string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.BLOCKLISTING.BLOCK_CODECódigo de bloqueio do número.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.BLOCKLISTING.BLOCK_DESCRIPTIONDescrição do status de bloqueio (ex.: NOT BLOCKED).string
CampoDescriçãoFormato
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.LOCATION.CITYCidade associada ao número.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.LOCATION.COUNTRY.NAMEPaís associado ao número.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.CLEANSING.CALL.COUNTRY_CODECódigo do país para chamada.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.CLEANSING.CALL.PHONE_NUMBERNúmero de telefone normalizado para chamada (sem código do país).string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.ORIGINAL.COMPLETE_PHONE_NUMBERNúmero completo original enviado na requisição.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.ORIGINAL.COUNTRY_CODECódigo do país original.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.ORIGINAL.PHONE_NUMBERNúmero de telefone original (sem código do país).string
CampoDescriçãoFormato
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CARRIER.NAMENome da operadora do telefone.string
CampoDescriçãoFormato
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.FIRST_NAMEPrimeiro nome do titular da linha.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.LAST_NAMESobrenome do titular da linha.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ADDRESS1Endereço principal do contato.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ADDRESS2Campo adicional de endereço.array
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ADDRESS3Campo adicional de endereço.array
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ADDRESS4Campo adicional de endereço.array
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.CITYCidade do endereço do contato.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.STATE_PROVINCEEstado ou província do contato.array
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.COUNTRYPaís do contato (sigla).string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ZIP_POSTAL_CODECódigo postal do endereço do contato.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.EMAIL_ADDRESSEndereço de e-mail do contato.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.DATE_OF_BIRTHData de nascimento do contato.string
RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.IDDocumento de identificação do contato.string

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

Objeto de consulta com o número de telefone a ser pesquisado.

ConsultaobjectRequired

Response

Resposta da consulta:

  • Código 1: Sucesso.
  • Código 2: Dado não encontrado na base de dados.
  • Código 3: Erro na consulta.

Errors

400
Bad Request Error
401
Unauthorized Error