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

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

$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;
}

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);

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

{
	"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"
		},
	],
}

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"
}

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
}

docStatus

Situação cadastral do CPF.

Valor

Descrição

Regular

Suspenso

Falecido

Pendente

Cancelado

gender

Gênero de nascença da pessoa

Valor

Descrição

Masculino

Feminino

score

Pontuação de crédito presumido da pessoa

Valor

Descrição

Péssimo

Ruim

Normal

Bom

Excelente

AnteriorBigdata PróximoConsulta CNPJ

Atualizado há 2 meses