Doações Políticas

Doações políticas de uma pessoa

Lista paginada das doações eleitorais declaradas ao TSE em que o CPF aparece como doador direto (origem = direta) ou doador originário de repasse intermediado (origem = originaria, com o intermediário que repassou), mais um resumo agregado. Os filtros se aplicam à página E ao total/resumo. Documento com dígito verificador inválido ou sem doações responde 200 com total 0 (crédito reembolsado automaticamente) — nunca 400/404. Cobertura atual: eleições 2018, 2020, 2022 e 2024.

GET

doacoes-politicas

cpf

{cpf}

Doações políticas de uma pessoa

curl --request GET \
  --url 'https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token='

const options = {method: 'GET'};

fetch('https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "documento": "12345678901",
  "tipo_documento": "cpf",
  "nome": "João Da Silva",
  "total": 7,
  "limit": 2,
  "offset": 0,
  "resumo": {
    "valor_total": 15500,
    "valor_financeiro": 13000,
    "valor_estimavel": 2500,
    "quantidade": 7,
    "anos": [
      2022,
      2020,
      2018
    ],
    "beneficiarios_distintos": 4,
    "partidos_distintos": 3,
    "por_ano": [
      {
        "ano": 2022,
        "valor": 8000,
        "quantidade": 3
      },
      {
        "ano": 2020,
        "valor": 4500,
        "quantidade": 2
      },
      {
        "ano": 2018,
        "valor": 3000,
        "quantidade": 2
      }
    ],
    "por_partido": [
      {
        "partido": "XYZ",
        "valor": 8000,
        "quantidade": 3
      },
      {
        "partido": "ABC",
        "valor": 4500,
        "quantidade": 2
      },
      {
        "partido": "DEF",
        "valor": 3000,
        "quantidade": 2
      }
    ]
  },
  "doacoes": [
    {
      "sq_receita": "20221234567890",
      "ano_eleicao": 2022,
      "turno": 1,
      "descricao_eleicao": "Eleições Gerais Estaduais 2022",
      "data": "2022-09-15",
      "valor": 5000,
      "natureza": "financeira",
      "especie": "Transferência eletrônica",
      "fonte_receita": "Outros",
      "origem_receita": "Recursos de pessoas físicas",
      "descricao": "Doação via PIX",
      "recibo": "000000123456XY",
      "origem": "originaria",
      "intermediario": {
        "nome": "Partido Xyz - Diretório Nacional",
        "documento": "01234567000189"
      },
      "beneficiario": {
        "tipo": "candidato",
        "sq_candidato": "250001234567",
        "cpf": "12345678909",
        "nome": "Maria Oliveira",
        "numero": "1234",
        "cargo": "Deputado Federal",
        "partido": "XYZ",
        "uf": "SP",
        "municipio": null,
        "cnpj_prestador": "45678901000123"
      }
    },
    {
      "sq_receita": "20229876543210",
      "ano_eleicao": 2022,
      "turno": 1,
      "descricao_eleicao": "Eleições Gerais Estaduais 2022",
      "data": "2022-08-20",
      "valor": 2500,
      "natureza": "estimavel",
      "especie": "Estimado",
      "fonte_receita": "Outros",
      "origem_receita": "Recursos de pessoas físicas",
      "descricao": "Cessão de veículo para a campanha",
      "recibo": null,
      "origem": "direta",
      "intermediario": null,
      "beneficiario": {
        "tipo": "candidato",
        "sq_candidato": "250007654321",
        "cpf": "98765432100",
        "nome": "José Pereira",
        "numero": "45",
        "cargo": "Governador",
        "partido": "XYZ",
        "uf": "SP",
        "municipio": null,
        "cnpj_prestador": "56789012000134"
      }
    }
  ]
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "path": "/api/v1/doacoes-politicas/cpf/12345678901",
  "timestamp": "2026-07-11T10:45:18.042Z"
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "path": "/api/v1/doacoes-politicas/cpf/12345678901",
  "timestamp": "2026-07-11T10:45:18.042Z"
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "path": "/api/v1/doacoes-politicas/cpf/12345678901",
  "timestamp": "2026-07-11T10:45:18.042Z"
}

Authorizations

token

string

query

required

Path Parameters

cpf

string

required

CPF do doador (com ou sem formatação; não-dígitos são removidos)

Example:

"12345678901"

Query Parameters

limit

integer

default:100

Tamanho da página (default 100; máximo 500 — valores fora da faixa são ajustados, não rejeitados)

Example:

100

offset

integer

default:0

Deslocamento da página (default 0; máximo 50000 — valores fora da faixa são ajustados)

Example:

0

ano

integer

Filtra pelo ano da eleição (ex.: 2022). Aplica-se também ao total e ao resumo

Example:

2022

string

UF da prestação de contas do beneficiário (27 UFs + BR/VT/ZZ; case-insensitive)

Example:

"SP"

partido

string

Sigla do partido do beneficiário (case-insensitive)

Example:

"XYZ"

cargo

string

Cargo do beneficiário (ex.: Vereador, Deputado Federal; case-insensitive)

Example:

"Deputado Federal"

Response

Envelope com total, resumo agregado e página de doações. total 0 quando não há resultados ou o documento é inválido (crédito reembolsado) — nunca 404

documento

string

Documento consultado (apenas dígitos)

Example:

"12345678901"

tipo_documento

enum<string>

Available options:

cpf,

cnpj

Example:

"cpf"

nome

string | null

Nome do doador (Title Case; prioriza o nome na Receita Federal). null quando total = 0

Example:

"João Da Silva"

total

integer

Total de doações COM os filtros aplicados (não é o tamanho da página) — base da paginação. 0 = sem doações, documento inválido ou base indisponível (crédito reembolsado)

Example:

7

limit

integer

Tamanho da página aplicado (após clamp)

Example:

100

offset

integer

Deslocamento aplicado (após clamp)

Example:

0

resumo

object | null

Resumo agregado com os filtros aplicados; null quando total = 0

Show child attributes

doacoes

object[]

Página de doações, ordenada por ano DESC e data DESC

Show child attributes

⌘I

Doações políticas de uma pessoa

curl --request GET \
  --url 'https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token='

const options = {method: 'GET'};

fetch('https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://221b-api.sherlocker.com.br/api/v1/doacoes-politicas/cpf/{cpf}?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "documento": "12345678901",
  "tipo_documento": "cpf",
  "nome": "João Da Silva",
  "total": 7,
  "limit": 2,
  "offset": 0,
  "resumo": {
    "valor_total": 15500,
    "valor_financeiro": 13000,
    "valor_estimavel": 2500,
    "quantidade": 7,
    "anos": [
      2022,
      2020,
      2018
    ],
    "beneficiarios_distintos": 4,
    "partidos_distintos": 3,
    "por_ano": [
      {
        "ano": 2022,
        "valor": 8000,
        "quantidade": 3
      },
      {
        "ano": 2020,
        "valor": 4500,
        "quantidade": 2
      },
      {
        "ano": 2018,
        "valor": 3000,
        "quantidade": 2
      }
    ],
    "por_partido": [
      {
        "partido": "XYZ",
        "valor": 8000,
        "quantidade": 3
      },
      {
        "partido": "ABC",
        "valor": 4500,
        "quantidade": 2
      },
      {
        "partido": "DEF",
        "valor": 3000,
        "quantidade": 2
      }
    ]
  },
  "doacoes": [
    {
      "sq_receita": "20221234567890",
      "ano_eleicao": 2022,
      "turno": 1,
      "descricao_eleicao": "Eleições Gerais Estaduais 2022",
      "data": "2022-09-15",
      "valor": 5000,
      "natureza": "financeira",
      "especie": "Transferência eletrônica",
      "fonte_receita": "Outros",
      "origem_receita": "Recursos de pessoas físicas",
      "descricao": "Doação via PIX",
      "recibo": "000000123456XY",
      "origem": "originaria",
      "intermediario": {
        "nome": "Partido Xyz - Diretório Nacional",
        "documento": "01234567000189"
      },
      "beneficiario": {
        "tipo": "candidato",
        "sq_candidato": "250001234567",
        "cpf": "12345678909",
        "nome": "Maria Oliveira",
        "numero": "1234",
        "cargo": "Deputado Federal",
        "partido": "XYZ",
        "uf": "SP",
        "municipio": null,
        "cnpj_prestador": "45678901000123"
      }
    },
    {
      "sq_receita": "20229876543210",
      "ano_eleicao": 2022,
      "turno": 1,
      "descricao_eleicao": "Eleições Gerais Estaduais 2022",
      "data": "2022-08-20",
      "valor": 2500,
      "natureza": "estimavel",
      "especie": "Estimado",
      "fonte_receita": "Outros",
      "origem_receita": "Recursos de pessoas físicas",
      "descricao": "Cessão de veículo para a campanha",
      "recibo": null,
      "origem": "direta",
      "intermediario": null,
      "beneficiario": {
        "tipo": "candidato",
        "sq_candidato": "250007654321",
        "cpf": "98765432100",
        "nome": "José Pereira",
        "numero": "45",
        "cargo": "Governador",
        "partido": "XYZ",
        "uf": "SP",
        "municipio": null,
        "cnpj_prestador": "56789012000134"
      }
    }
  ]
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "path": "/api/v1/doacoes-politicas/cpf/12345678901",
  "timestamp": "2026-07-11T10:45:18.042Z"
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "path": "/api/v1/doacoes-politicas/cpf/12345678901",
  "timestamp": "2026-07-11T10:45:18.042Z"
}

{
  "statusCode": 400,
  "message": "Validation failed",
  "path": "/api/v1/doacoes-politicas/cpf/12345678901",
  "timestamp": "2026-07-11T10:45:18.042Z"
}

Perfil Completo

Entidades

Pessoa Física

Pessoa Jurídica

Telefones & Emails

Dívidas

Benefícios Sociais

Licitações

Listas Restritivas