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. <Note> 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. </Note> ## TABELA DE CAMPOS DE REQUISIÇÃO | **Campo** | **Descrição** | **Formato** | **Obrigatório** | |-----------|---------------|-------------|-----------------| | **IdConsulta** | Identificador da consulta. Valor fixo: `492`. | string | Sim | | **Telefone** | Número de telefone no formato `55DDD999999999`. | string | Sim | ## TABELA DE CAMPOS DE RETORNO <AccordionGroup> <Accordion title="Cabeçalho da Resposta — CONSULTA"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **CONSULTA.CODIGORESPOSTA** | Código interno de resposta gerado pela Credify. | string | | **CONSULTA.DATAHORA** | Data e hora da consulta no formato DD/MM/AAAA HH:MM:SS. | string | | **CONSULTA.LOGON** | Identificador do usuário que realizou a consulta. | string | | **CONSULTA.IDCONSULTA** | Identificador da consulta enviado na requisição. | string | | **RESPOSTA.CODIGO** | Código de status da resposta (`1` = sucesso, `2` = não encontrado, `3` = erro). | string | </Accordion> <Accordion title="📱 Tipo e Bloqueio do Telefone"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.PHONE_TYPE.CODE** | Código do tipo de telefone. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.PHONE_TYPE.DESCRIPTION** | Descrição do tipo de telefone (ex.: `MOBILE`, `LANDLINE`). | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.BLOCKLISTING.BLOCKED** | Indica se o número está bloqueado (`TRUE` / `FALSE`). | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.BLOCKLISTING.BLOCK_CODE** | Código de bloqueio do número. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.BLOCKLISTING.BLOCK_DESCRIPTION** | Descrição do status de bloqueio (ex.: `NOT BLOCKED`). | string | </Accordion> <Accordion title="📍 Localização e Numeração"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.LOCATION.CITY** | Cidade associada ao número. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.LOCATION.COUNTRY.NAME** | País associado ao número. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.CLEANSING.CALL.COUNTRY_CODE** | Código do país para chamada. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.CLEANSING.CALL.PHONE_NUMBER** | Número de telefone normalizado para chamada (sem código do país). | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.ORIGINAL.COMPLETE_PHONE_NUMBER** | Número completo original enviado na requisição. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.ORIGINAL.COUNTRY_CODE** | Código do país original. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.NUMBERING.ORIGINAL.PHONE_NUMBER** | Número de telefone original (sem código do país). | string | </Accordion> <Accordion title="📡 Operadora — CARRIER"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CARRIER.NAME** | Nome da operadora do telefone. | string | </Accordion> <Accordion title="👤 Dados do Titular — CONTACT"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.FIRST_NAME** | Primeiro nome do titular da linha. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.LAST_NAME** | Sobrenome do titular da linha. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ADDRESS1** | Endereço principal do contato. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ADDRESS2** | Campo adicional de endereço. | array | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ADDRESS3** | Campo adicional de endereço. | array | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ADDRESS4** | Campo adicional de endereço. | array | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.CITY** | Cidade do endereço do contato. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.STATE_PROVINCE** | Estado ou província do contato. | array | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.COUNTRY** | País do contato (sigla). | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ZIP_POSTAL_CODE** | Código postal do endereço do contato. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.EMAIL_ADDRESS** | Endereço de e-mail do contato. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.DATE_OF_BIRTH** | Data de nascimento do contato. | string | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CONTACT.ID** | Documento de identificação do contato. | string | </Accordion> </AccordionGroup>