Endpoint: situación militar (libreta militar) por documento

Con la cédula o la tarjeta de identidad de una persona consulta su registro de situación militar y responde en qué estado está su tarjeta militar, con el nombre del titular tal como lo registra el Comando de Reclutamiento del Ejército. Sirve para verificar lo que declara un candidato o un contratista sin pedirle el documento físico. Responde en segundos y un «no registra» es una respuesta válida que se cobra, pero no prueba que la situación esté sin definir.

POST/api/situacion-militar1 crédito

La situación militar de una persona por cédula o tarjeta de identidad: si el registro de reclutamiento la tiene inscrita, el estado de su tarjeta militar (estado, tal cual lo escribe el certificado: «INSCRIPCIÓN», «CITADO - 2DO EXAMEN», una situación definida…), definida (true cuando el registro reporta la situación como definida, es decir, tarjeta expedida; false si sigue en trámite; null si el estado no se reconoce o no es concluyente, p. ej. «EXENTO»), el nombre del titular y la fecha del certificado. Responde en ~1 s. Si la persona está registrada con el OTRO tipo (la mandaste por CC y figura con TI, o al revés), se responde ese registro: tipoDocumento trae el tipo real y tipoDocumentoConsultado el que mandaste. Un documento que el registro no tiene con ninguno de los dos tipos responde 200 con inscrito: false y COBRA: es el hallazgo que se viene a buscar, pero no prueba que la situación esté sin definir (las mujeres no están obligadas a inscribirse). ⚠️ Solo CC y TI: es el universo del registro. Cuesta 1 crédito.

Para qué sirve, quién lo usa y cuánto cuesta: API de situación militar.

Cuerpo de la solicitud

body (JSON)
{
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
docTypestringTipo de documento. Por defecto `CC`. El registro solo maneja cédula y tarjeta de identidad; con otro valor responde 400 `bad_request` sin cobrar.Valores: CC · TI
docNumberobligatoriostringNúmero de documento, de 1 a 11 dígitos (se aceptan puntos y espacios). Alias aceptados: `doc`, `documento`.
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/situacion-militar' \
  -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/situacion-militar", {
  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/situacion-militar",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "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"
  },
  "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: 16 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto