API de situación militar: verificar la libreta militar por documento

PlacApi responde en JSON, en ~1 segundo, si una persona aparece en el registro de reclutamiento del Ejército con ese documento, en qué estado está su tarjeta militar —inscripción, citación, situación definida— y el nombre del titular tal como lo registra el Comando de Reclutamiento. definida: true indica que el registro reporta la situación como definida (tarjeta expedida). Se consulta con la cédula o la tarjeta de identidad y cuesta 1 crédito.

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

La situación militar se verifica hoy pidiéndole al candidato una copia de la libreta o un certificado que él mismo descarga, y nadie confirma que el documento sea suyo ni que siga vigente. Para un área de talento humano que vincula cientos de personas, o para una plataforma que verifica candidatos y contratistas, eso es un paso manual por persona. Este endpoint lo vuelve una llamada: el documento entra, el estado sale.

Para quién sirve

Áreas de talento humano y empresas de servicios temporales, plataformas de verificación de candidatos y estudios de seguridad, entidades públicas que validan a sus contratistas, y fintechs que completan un expediente de identidad.

Datos requeridos

  • docType — CC o TI. Por defecto CC. Es el universo del registro: no maneja cédula de extranjería ni pasaporte.
  • docNumber — número de documento; se aceptan puntos y espacios.

Fuentes y cobertura

  • Comando de Reclutamiento y Control Reservas del Ejército NacionalRegistro de la situación militar de los colombianos: inscripción, citaciones, clasificación y la tarjeta militar expedida.

¿Cuánto cuesta consultar la situación militar por API?

1 crédito por consulta, y un «no registra» también se cobra porque es el dato que se viene a buscar. Una consulta servida de caché no cobra.

¿Cómo verificar por API si alguien tiene la libreta militar?

Con un POST a /api/situacion-militar enviando docType (CC o TI) y docNumber. inscrito dice si el registro tiene a la persona y definida si el registro reporta su situación como definida.

Ejemplo de solicitud

POST https://placapi.com/api/situacion-militar. 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/situacion-militar' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"docType":"CC","docNumber":"1020304050"}'

Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/situacion-militar.

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": "situacion-militar",
  "status": "info",
  "data": {
    "documento": "1020304050",
    "tipoDocumento": "CC",
    "inscrito": true,
    "definida": false,
    "nombre": "JUAN CARLOS PEREZ GOMEZ",
    "estado": "INSCRIPCIÓN - EN REGISTRO",
    "fechaCertificacion": "16 de OCTUBRE de 2026"
  }
}

Explicación campo por campo

CampoTipoDescripción
inscritobooleantrue si el registro tiene a esa persona con ese tipo y número de documento. false es una respuesta válida y se cobra.
definidaboolean | nulltrue cuando el registro reporta la situación como definida (tarjeta expedida); false si sigue en trámite (inscripción, citación); null si el estado no se reconoce o no es concluyente (p. ej. «EXENTO»): en ese caso leer estado.
estadostringEstado de la tarjeta militar tal como lo escribe el certificado.
nombrestringNombre completo del titular, en el orden del registro.

Tiempo de respuesta

~1 segundo. Una sola consulta al registro, sin navegador.

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. Por la web, el informe completo por placa cuesta 3 créditos. 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

7 días cuando la persona está inscrita; 1 hora cuando no lo está, para que un documento mal digitado no herede el «no registra».

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

  • Solo cédula y tarjeta de identidad: el registro no maneja otros documentos.
  • Un inscrito: false dice que el registro no tiene a esa persona con ese tipo y número de documento. Antes de responderlo se prueba también el otro tipo (CC y TI), así que no es un error de tipo de documento.
  • inscrito: false no significa «situación militar sin definir»: las mujeres no están obligadas a inscribirse y no consta que todos los registros antiguos estén en este sistema.
  • El estado es el que publica el registro el día de la consulta; PlacApi no interpreta la clasificación más allá de definida, que solo es true con un estado inequívoco.

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

Otras preguntas frecuentes

¿Qué significa `definida: false`?

+

Que la persona está en el registro pero su situación militar sigue en trámite: inscripción, citación a examen u otro paso previo a la tarjeta. El estado exacto viene en estado.

¿Sirve con cédula de extranjería?

+

No. El registro de reclutamiento solo maneja cédula de ciudadanía y tarjeta de identidad.

Seguir explorando

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

Contacto