Datos Maestros

Datos de referencia públicos (sin autenticación): países, departamentos, ciudades, tipos de documento e identidad y tipos de organización DIAN.

📄️Listar países activos

Público (sin autenticación). Retorna los países con `active` = 1, con todos sus campos. Resultado cacheado 24 horas.

📄️Listar departamentos

Público (sin autenticación). Retorna todos los departamentos registrados, sin filtro por país ni paginación. Resultado cacheado 24 horas.

📄️Listar ciudades

Público (sin autenticación). Retorna ciudades con su departamento y sus códigos postales, sin paginación (sin filtros devuelve todas). Filtros opcionales: `query` (coincidencia parcial en nombre o código de ciudad) y `code` (código exacto). Use solo uno de los dos: si se combinan, el resultado incluye las ciudades cuyo nombre coincide con `query` aunque no tengan el código `code`. No se cachea.

📄️Listar tipos de organización

Público (sin autenticación). Retorna todos los tipos de organización (tabla `type_organization`). Valores actuales: 1 = Persona Jurídica, 2 = Persona Natural. El `id` es el que se envía como `type_organization_id`. Resultado cacheado 4 horas.

📄️Listar tipos de documento de identidad

Público (sin autenticación). Retorna los tipos de documento de identidad activos (`active` = 1), p. ej. Cédula de Ciudadanía, Cédula de Extranjería, NIT, Pasaporte, PPT, PEP. El `id` es el que se envía como `identity_document_id`. Resultado cacheado 4 horas.

📄️Listar tipos de documento constitutivo (Cámara de Comercio, etc.)

Público (sin autenticación). Retorna los tipos de documento constitutivo activos, usados en solicitudes de Persona Jurídica. Valores iniciales: 1 = CC (Cámara de Comercio), 2 = PJ (Personería Jurídica). El `id` es el que se envía como `entity_document_type_id`. Resultado cacheado 4 horas.

📄️Versión vigente de los Términos y Condiciones

Público (sin autenticación). Devuelve la versión marcada como vigente (si hubiera varias, la de `published_at` más reciente): id, etiqueta de versión, fecha de publicación, URL pública y hash SHA-256 del texto normalizado. No incluye el texto completo. El `id` debe enviarse como `terms_version_id` al crear una solicitud de certificado (`POST /certificate-request`).