Endpoint: nombre del titular por documento

Devuelve el nombre completo del titular de un documento de identidad y ese mismo nombre ya partido en el arreglo partes, para no tener que adivinar del lado del cliente dónde termina el nombre y empieza el apellido. Consulta dos registros en cascada: primero el registro social del DNP, que responde al instante y trae de paso sexo, edad, municipio y departamento, y si la persona no figura ahí cae al certificado de la Procuraduría. El campo origen dice cuál respondió.

POST/api/cedula1 crédito

Nombre completo del titular de un documento de identidad. Devuelve el nombre ya partido en `partes`, para no tener que adivinar del lado del cliente dónde termina el nombre y empieza el apellido. Consulta DOS registros en cascada: primero el registro social del DNP —instantáneo, y de regalo trae `sexo`, `edad`, `municipio` y `departamento`—, y si la persona no figura ahí cae al certificado de la Procuraduría, que cubre a cualquiera con documento colombiano pero tarda más. `origen` dice cuál respondió, así se sabe por qué unos campos vienen vacíos. Es el primer paso de cualquier verificación: confirmar que el documento existe y a quién pertenece antes de gastar consultas en antecedentes o en el vehículo. **Un documento sin titular registrado responde 404 y NO cobra** — a diferencia de los antecedentes, donde "no registra" sí cobra: acá el producto es el nombre, y si no vino no se entregó nada. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)
{
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
docTypeobligatoriostringTipo de documento. La cobertura depende de cuál de los dos registros responda: el social maneja RC, TI, CC, CE, PA, PEP y PPT; el certificado maneja CC, CE, NIT, PPT y PEP. Un tipo que ninguno acepta responde 400 `tipo_documento_no_soportado` sin cobrar.Valores: CC · CE · TI · RC · PA · NIT · PPT · PEP
docNumberobligatoriostringNúmero de documento. Alias aceptado: `doc`.
primerNombrestringPrimer nombre del titular. OPCIONAL: solo se usa si la consulta cae al certificado, donde ahorra un par de peticiones al resolver la pregunta de seguridad del portal. No cambia el resultado ni la caché.
refreshbooleanIgnora 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/cedula' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/cedula", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/cedula",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "source": "identidad",
  "status": "info",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "Cédula de ciudadanía",
    "nombre": "JUAN CARLOS PEREZ GOMEZ",
    "partes": [
      "JUAN",
      "CARLOS",
      "PEREZ",
      "GOMEZ"
    ],
    "sexo": "Masculino",
    "edad": 38,
    "municipio": "CALI",
    "departamento": "VALLE DEL CAUCA",
    "origen": "registro-social"
  },
  "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: 23 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto