> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.credify.com.br/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.credify.com.br/_mcp/server. # Proprietário Telefone Operadora POST https://api.credify.com.br/proprietariotelefoneoperadora Content-Type: application/json 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 | **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 | **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 | | **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 | | **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 | | **Campo** | **Descrição** | **Formato** | | :------------------------------------------------------ | :----------------------------- | :---------- | | **RESPOSTA.PROPRIETARIOTELEFONEOPERADORA.CARRIER.NAME** | Nome da operadora do telefone. | string | | **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 | Reference: https://docs.credify.com.br/api-reference/api-reference/8-antifraude-e-validacoes/8-1-validacao-cadastral-e-vinculo/proprietario-telefone-operadora ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Body (application/json) This endpoint expects a ProprietariotelefoneoperadoraRequest. - `Consulta` (ProprietariotelefoneoperadoraRequestConsulta, required) ## Response ### 200 Resposta da consulta: * Código `1`: Sucesso. * Código `2`: Dado não encontrado na base de dados. * Código `3`: Erro na consulta. - `map from string to any` ## Errors ### 400 Bad Request Error Requisição inválida — verifique o body enviado. - `any` ### 401 Unauthorized Error Token inválido ou expirado. Renove o token JWT via `/auth`. - `any` ## Types ### ProprietariotelefoneoperadoraRequestConsulta - `IdConsulta` (string, required) — Identificador da consulta. Valor fixo 492. - `Telefone` (string, required) — Número de telefone no formato `55DDD999999999`. ## Examples **Request** ```json { "Consulta": { "IdConsulta": "492", "Telefone": "" } } ``` **Response** ```json { "CONSULTA": { "CODIGORESPOSTA": "51118765", "DATAHORA": "13/06/2024 13:20:32", "IDCONSULTA": "492", "LOGON": "28111" }, "RESPOSTA": { "CODIGO": "1", "PROPRIETARIOTELEFONEOPERADORA": { "BLOCKLISTING": { "BLOCKED": "FALSE", "BLOCK_CODE": "0", "BLOCK_DESCRIPTION": "NOT BLOCKED" }, "CARRIER": { "NAME": "TIM CELULAR S.A." }, "CONTACT": { "ADDRESS1": "STREET NAME 1234", "ADDRESS2": [], "ADDRESS3": [], "ADDRESS4": [], "CITY": "SAO PAULO", "COUNTRY": "BR", "DATE_OF_BIRTH": "1900-01-01", "EMAIL_ADDRESS": "ANONYMOUS@EMAIL.COM", "FIRST_NAME": "ANON", "ID": "00000000000", "LAST_NAME": "YMIZED", "STATE_PROVINCE": [], "ZIP_POSTAL_CODE": "00000000" }, "LOCATION": { "CITY": "SAO PAULO", "COUNTRY": { "NAME": "BRAZIL" } }, "NUMBERING": { "CLEANSING": { "CALL": { "COUNTRY_CODE": "55", "PHONE_NUMBER": "11999999999" } }, "ORIGINAL": { "COMPLETE_PHONE_NUMBER": "5511999999999", "COUNTRY_CODE": "55", "PHONE_NUMBER": "11999999999" } }, "PHONE_TYPE": { "CODE": "2", "DESCRIPTION": "MOBILE" } } } } ``` **SDK Code** ```python Consulta Sucesso import requests url = "https://api.credify.com.br/proprietariotelefoneoperadora" payload = { "Consulta": { "IdConsulta": "492", "Telefone": "" } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Consulta Sucesso const url = 'https://api.credify.com.br/proprietariotelefoneoperadora'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"Consulta":{"IdConsulta":"492","Telefone":""}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Consulta Sucesso package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.credify.com.br/proprietariotelefoneoperadora" payload := strings.NewReader("{\n \"Consulta\": {\n \"IdConsulta\": \"492\",\n \"Telefone\": \"\"\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Consulta Sucesso require 'uri' require 'net/http' url = URI("https://api.credify.com.br/proprietariotelefoneoperadora") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"Consulta\": {\n \"IdConsulta\": \"492\",\n \"Telefone\": \"\"\n }\n}" response = http.request(request) puts response.read_body ``` ```java Consulta Sucesso import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.credify.com.br/proprietariotelefoneoperadora") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"Consulta\": {\n \"IdConsulta\": \"492\",\n \"Telefone\": \"\"\n }\n}") .asString(); ``` ```php Consulta Sucesso request('POST', 'https://api.credify.com.br/proprietariotelefoneoperadora', [ 'body' => '{ "Consulta": { "IdConsulta": "492", "Telefone": "" } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Consulta Sucesso using RestSharp; var client = new RestClient("https://api.credify.com.br/proprietariotelefoneoperadora"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"Consulta\": {\n \"IdConsulta\": \"492\",\n \"Telefone\": \"\"\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Consulta Sucesso import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["Consulta": [ "IdConsulta": "492", "Telefone": "" ]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.credify.com.br/proprietariotelefoneoperadora")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```