Endpoint: identidad Brasil (CPF)

Devuelve el nombre completo de una persona brasileña a partir del CPF, validado contra la base de la Receita Federal por medio de la certidão del Tribunal de Contas da União. El CPF se valida sin red antes de cobrar: uno con los dígitos verificadores mal responde 400 y no gasta la consulta, y un CPF que no existe responde 404 sin cobro. La consulta sale desde una salida brasileña; si la fuente no responde, la respuesta es source_error sin cobro. Fecha de nacimiento, sexo y estado vital no se publican por esta vía y viajan en cobertura.noPublicados.

POST/api/identidad-br1 crédito

Nombre completo de una persona brasileña por CPF, contra la certidão de contas julgadas irregulares del TCU. El nombre lo entrega el TCU validando el CPF contra la base de la Receita Federal, y la consulta es SOLO con el CPF: la fecha de nacimiento es opcional y solo se usa si hay contrato SERPRO, la vía que además entrega fecha de nacimiento, edad y situação cadastral. El CPF se valida con sus dos dígitos verificadores ANTES de consultar —uno mal escrito no puede existir— y un CPF que no existe en Receita responde 404 no_encontrado sin cobrar. isAlive llega false SOLO cuando la Receita marca «Titular Falecido» (vía SERPRO); en cualquier otro caso es null, y el sexo no se publica (va en cobertura.noPublicados). Por TCU la respuesta trae además el código de control de la certidão emitida (validez 30 días). Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)

{
  "documento": "52998224725",
  "fechaNacimiento": "1990-05-14"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
documentoobligatorio	string	CPF con 11 dígitos (sin puntos ni guiones). Se valida el dígito verificador módulo 11; si no cuadra responde 400 sin cobrar. Alias aceptados: `cpf`, `doc`.
fechaNacimiento	string	Opcional. La vía por defecto (TCU) consulta solo con el CPF. Si el proyecto tiene contrato SERPRO y mandas la fecha, la consulta va a SERPRO y devuelve además fecha de nacimiento, edad y situação cadastral. Acepta `AAAA-MM-DD`, `DD/MM/AAAA` y `DDMMAAAA`.
refresh	boolean	Ignora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL

curl -X POST 'https://placapi.com/api/identidad-br' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"documento":"52998224725","fechaNacimiento":"1990-05-14"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/identidad-br", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"documento":"52998224725","fechaNacimiento":"1990-05-14"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/identidad-br",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"documento":"52998224725","fechaNacimiento":"1990-05-14"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "source": "identidad-br",
  "status": "ok",
  "data": {
    "documento": "52998224725",
    "tipoDocumento": "CPF",
    "nombre": "MARIA DA SILVA SOUZA",
    "nombres": "MARIA DA",
    "apellidos": "SILVA SOUZA",
    "fechaNacimiento": null,
    "edad": null,
    "sexo": null,
    "isAlive": null,
    "situacaoCadastral": null,
    "situacaoCodigo": null,
    "cobertura": {
      "nombre": true,
      "fechaNacimiento": false,
      "sexo": false,
      "isAlive": false,
      "noPublicados": [
        "fechaNacimiento",
        "sexo",
        "isAlive"
      ]
    }
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 30 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.