Consulta CPF

Informações e detalhes para consulta do documento brasileiro CPF

Este serviço é destinado para consultar dados de uma pessoa física brasileira a partir do seu documento CPF.

Há possibilidade de dados desatualizados ou até mesmo a inexistência, mas ainda assim a chance de contato direto (CCD) do documento pesquisado é de aproximadamente 90%

Requisição

GET https://api-v3.smsfire.com.br/bigdata/cpf/:input

Rate Limiter: Este serviço possui um limite global de 30 requisições por minuto a partir do mesmo IP.

Parâmetros de requisição

Parâmetro	Tipo	Descrição	Exemplo
input*	string	Documento CPF a ser pesquisado	12365478909

Exemplos de requisição

Node.JS

var axios = require("axios").default;

const input = "12365478909";

var options = {
  method: 'GET',
  url: `https://api-v3.smsfire.com.br/bigdata/cpf/${input}`,
  headers: {Username: 'seu_usuario', Api_Token: 'seu_token'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Php

<?php

$endpoint = "https://api-v3.smsfire.com.br/bigdata/cpf/";
$endpoint .= "12365478909";

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => $endpoint,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "Api_Token: seu_token",
        "Username: seu_usuario",
    ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}

C-Sharp

using System.Net.Http;
using Microsoft.AspNetCore.WebUtilities; // precisa do pacote Microsoft.AspNetCore.WebUtilities

var client = new HttpClient();

var input = "12365478909";
var endpoint = $"https://api-v3.smsfire.com.br/bigdata/cpf/{input}";

var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri(endpoint),
    Headers =
    {
        { "Api_Token", "seu_token" },
        { "Username", "seu_usuario" }
    }
};

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Shell/cURL

curl --request GET \
  --url 'https://api-v3.smsfire.com.br/bigdata/cpf/12365478909' \
  --header 'Api_Token: seu_token' \
  --header 'Username: seu_usuario'

Somente consultas com dados disponíveis serão tarifadas.

Response

O conjunto de dados retornados será em formato JSON com detalhes da pesquisa ou possível falha da requisição

200 - OK

{
	"id": "0199b9bf-1544-70ad-95b3-7c7605ab8aec",
	"ip": "127.0.0.1",
	"doc": "12365478909",
	"docStatus": 0,
	"fullname": "joão da silva junior",
	"birthday": "1990-01-01",
	"gender": 1,
	"mother": "maria da silva",
	"father": "joao da silva",
	"dead": false,
	"income": "5100",
	"score": 2,
	"occupation": "vendeddor",
	"pep": false,
	"maritalStatus": 1,
	"emails": [ "[email protected]" ],
	"phones": [
		{
			"prefix": "55",
			"area": "11",
			"phone": "944556677",
			"national": "11944556677",
			"international": "5511944556677"
		},
	],
	"addresses": [
		{
			"street": "rua vinte e cinco",
			"number": "10",
			"complement": "apartamento 10b",
			"neighborhood": "tucuruvi",
			"city": "são paulo",
			"state": "sp",
			"country": "brasil",
			"zipcode": "02040000",
			"updated_at": "2025-06-20T15:59:21.000Z"
		},
	],
	"business": [
		{
			"doc": "19500600000109",
			"name": "empresa do joao da silva ltda"
		},
	],
}

404 - Not found

Esse código de erro será lançado quando a consulta não possuir dados disponíveis em nossas bases de dados.

{
	"id": "0199b9be-e86e-7519-a1ad-85498d340628",
	"ip": "127.0.0.1",
	"status": "NOT_FOUND"
}

4xx - Erro

Erros poderão ser facilmente filtrados a partir dos códigos HTTP retornados e adicionalmente detalhes do erro serão incluídos no JSON que seguirá o seguinte formato:

{
	"message": "Not Available Balance",
	"error": "Forbidden",
	"statusCode": 403
}

5xx - Erro

Requisições que tenham o retorno de algum código HTTP deste nível é devido a falhas internas da API ou servidor.

Neste tipo de situação, entre em contato com a equipe de suporte

Tabela de parâmetros

Parâmetro	Tipo	Descrição
id	string Padrão UUID	Identificador único da pesquisa
ip	string	Ip de onde se originou o request a API
doc	string	Documento a pessoa pesquisada
docStatus	number	Situação cadastral do documento
fullname	string	Nome completo
birthday	string AAAA-MM-DD	Data de nascimento
gender	number	Gênero de nascimento
mother	string	Nome completo da mãe
father	string | null	Nome completo do pai
dead	boolean	Confirmação de óbito
income	string	Renda presumida
score	number	Score de crédito presumido
occupation	string	Profissão presumida
pep	boolean	Pessoa exposta politicamente
maritalStatus	number	Estado cívil
emails	string[]	Relação de e-mails
phones	array	Matriz com relação de telefones
phones[].prefix	string	Código DDI do telefone
phones[].area	string	Código de área
phones[].phone	string	Número de telefone em formato local
phones[].national	string	Número de telefone em formato nacional
phones[].international	string	Número de telefone em formato internacional
addresses	array	Matriz com relação de endereços
addresses[].street	string	Nome da rua
addresses[].number	string | null	Número do endereço
addresses[].complement	string | null	Complemento do endereço
addresses[].neighborhood	string | null	Bairro
addresses[].city	string	Cidade
addresses[].state	string	Estado
addresses[].country	string	País
addresses[].zipcode	string	Código postal (CEP)
addresses[].updated_at	string | Date	Data da última atualização do item
business	array	Matriz com relação de participação societária
business[].doc	string	Cnpj da empresa
business[].name	string	Razão social da empresa

docStatus

Situação cadastral do CPF.

Valor	Descrição
0	Regular
2	Suspenso
3	Falecido
4	Pendente
5	Cancelado

gender

Gênero de nascença da pessoa

Valor	Descrição
1	Masculino
2	Feminino

score

Pontuação de crédito presumido da pessoa

Valor	Descrição
0	Péssimo
1	Ruim
2	Normal
3	Bom
4	Excelente