API para consultar el nombre por cédula en Colombia

PlacApi devuelve el nombre completo del titular de un documento de identidad y, además, ese nombre YA separado en partes, para que quien integra no tenga que adivinar dónde termina el nombre y empieza el apellido. Consulta dos registros oficiales en cascada: primero el registro social, que responde en menos de un segundo y trae de paso sexo, edad, municipio y departamento; y si la persona no figura ahí, el certificado de la Procuraduría, que cubre a cualquiera con documento colombiano. El campo origen dice cuál respondió.

Probar en el sandbox y generar API keyVer precios por consulta

¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.

Qué problema resuelve

Confirmar que un documento existe y a quién pertenece es el primer paso de cualquier verificación, y en Colombia no hay un servicio público de consulta de nombre por cédula abierto a desarrolladores: los portales que lo exponen están detrás de captchas. Validar la identidad antes de gastar consultas en antecedentes, en el vehículo o en la licencia evita pagar por consultas condenadas a fallar por un dígito mal escrito.

Para quién sirve

Cualquier flujo de registro o KYC que valide identidad, plataformas de crédito y seguros, áreas de talento humano que verifican una hoja de vida, y desarrolladores que quieren confirmar un documento antes de encadenar consultas más caras.

Datos requeridos

  • docType — tipo de documento (CC, CE, TI, RC, PA, NIT, PPT o PEP).
  • docNumber — número de documento.
  • primerNombre — opcional: solo se usa si la consulta cae al certificado, donde ahorra un par de peticiones.

Fuentes y cobertura

  • Registro social del DNPDatos básicos del ciudadano: nombre completo, sexo, edad, municipio y departamento. Es la primera fuente porque responde al instante y sin captcha.
  • Certificado de la Procuraduría General de la NaciónNombre completo del titular según el registro oficial. Se usa como respaldo: cubre a cualquier persona con documento colombiano, incluida la que no está en el registro social.

¿Cómo consultar el nombre de una persona por su cédula en Colombia?

Con una llamada POST a /api/cedula enviando docType y docNumber. La respuesta trae el nombre completo y también el nombre separado en partes. Cuando la persona está en el registro social se agregan sexo, edad, municipio y departamento.

¿Es legal consultar el nombre por número de cédula?

La consulta se hace sobre registros públicos que las propias entidades exponen para verificación. Quien consulta es responsable de tener una finalidad legítima y de cumplir el régimen de protección de datos; PlacApi actúa como encargado del tratamiento en el uso por API.

Ejemplo de solicitud

POST https://placapi.com/api/cedula. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

Ejemplo cURL de la solicitud
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"}'

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

Ejemplo de respuesta JSON
{
  "source": "identidad",
  "status": "info",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "CC",
    "nombre": "JUAN CARLOS PEREZ GOMEZ",
    "partes": [
      "JUAN",
      "CARLOS",
      "PEREZ",
      "GOMEZ"
    ],
    "sexo": "Masculino",
    "edad": 38,
    "municipio": "CALI",
    "departamento": "VALLE DEL CAUCA",
    "origen": "registro-social"
  }
}

Explicación campo por campo

CampoTipoDescripción
nombrestringNombre completo del titular según el registro que respondió.
partesarrayEl nombre ya separado en palabras. Los nombres colombianos suelen tener dos nombres y dos apellidos, pero no siempre, y las partículas (DE LA HOZ) no son un apellido aparte: partir la cadena en el cliente es donde se cometen los errores.
origenstringregistro-social o certificado. Le dice al integrador por qué unos campos vienen y otros no, en vez de dejarlo adivinando.
sexo, edad, municipio, departamentostringSolo cuando responde el registro social. Vienen vacíos si resolvió el certificado.

Tiempo de respuesta

Menos de un segundo en el caso mayoritario, que resuelve el registro social. Si cae al certificado, hasta un minuto.

Precio y cobro

1 crédito por consulta con datos, desde 349 COP. El precio por crédito baja por volumen: 349 COP desde 30, 249 COP desde 1.000, 149 COP desde 5.000, 139 COP desde 10.000, 119 COP desde 20.000, 99 COP desde 50.000. Los créditos se compran por adelantado (mínimo 30 = 10.470 COP), no vencen y no hay mensualidad. El mismo precio aplica por la web y por API. Solo se cobra cuando la consulta devuelve datos; por API, las consultas sin resultado (404) tienen 10 gratis al mes por cada tipo de respuesta sin datos y después cobran igual.

Caché y actualización

10 años. Los nombres no caducan, así que un caché corto solo obligaría a volver a consultar por un dato que no cambió.

Seguridad y privacidad

La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.

Limitaciones y posibles errores

  • Un documento sin titular registrado responde 404 y NO cobra. Es la diferencia con los antecedentes, donde 'no registra' sí cobra porque ese es el dato comprado: acá el producto es el nombre, y si no vino no se entregó nada.
  • Los campos sexo, edad y municipio solo llegan cuando responde el registro social, y no todo el mundo está en él. El campo origen permite saberlo sin adivinar.
  • No devuelve fotografía, huella ni estado de la cédula: no somos la Registraduría ni tenemos acceso a su base biométrica.
  • La cobertura por tipo de documento depende de cuál registro responda; un tipo que ninguno acepta se rechaza con 400 y sin cobrar.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

¿Por qué a veces no vienen la edad ni el municipio?

+

Porque esos campos solo los trae el registro social, y no todas las personas figuran ahí. Cuando la consulta la resuelve el certificado, el campo origen llega en 'certificado' y esos campos van vacíos.

¿Qué cuesta y qué pasa si la cédula no existe?

+

1 crédito. Si el documento no tiene titular registrado se responde 404 y no se cobra.

Seguir explorando

Última revisión: 19 de agosto de 2026 · Versión de la API: v1 · Fuentes y metodología

Contacto