Skip to main content
El Departamento Administrativo de la Función Pública mantiene el Gestor Normativo: 40.000 normas que rigen la administración pública colombiana, desde una ordenanza de 1620 hasta la circular de esta semana. No es un diario oficial ni una relatoría. Es donde una norma se publica con su aparato editorial: los temas bajo los que está clasificada, las normas posteriores que el gestor registra como adiciones, modificaciones o derogatorias, y el texto consolidado. Leyes, decretos, actos legislativos, sentencias del Consejo de Estado y los miles de conceptos con que Función Pública responde cómo se aplican las reglas están en el mismo registro, y ambos endpoints los recorren todos a la vez.

​
Buscar en el gestor

POST /co/funcion-publica/norms-search/v1 Una sola búsqueda sobre el texto completo de todas las normas del gestor, algo que el sitio del Gestor Normativo no ofrece: pagina de a diez y se detiene en diez mil resultados.
La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye as_of: qué tan actualizados están los datos.
Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total (coincidencias en todas las páginas), page, per_page, total_pages, count y results[], de la más reciente a la más antigua. Cada resultado incluye id, title (cómo se cita la norma), document_type y document_type_key, number y number_key (el mismo número sin ceros a la izquierda), year (el año en la designación de la norma), entity y entity_key (quién la expidió), summary (la descripción de una línea que publica el gestor), issued_at, effective_at, published_in, subjects[] y topics[] (de qué trata, según la clasificación del gestor), amendments[] (normas posteriores que el gestor registra como adiciones, modificaciones o derogatorias de esta, cada una con su norm_id para consultarla), official_url y document_url.
Los resultados de búsqueda no incluyen el texto de la norma: una sola norma puede tener cientos de miles de caracteres. query sí busca dentro de él, así que una frase que aparece en un artículo encuentra la norma; para leer el texto usa el endpoint Función Pública Norm.

​
Una norma, completa

POST /co/funcion-publica/norm/v1
La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye as_of: qué tan actualizados están los datos.
Devuelve as_of, found, norm_id y norm, que trae todo lo que devuelve la búsqueda más content: una ventana sobre el texto de la norma, con text, offset, total_length, has_more y next_offset. Cada resultado incluye id, title (cómo se cita la norma), document_type y document_type_key, number y number_key (el mismo número sin ceros a la izquierda), year (el año en la designación de la norma), entity y entity_key (quién la expidió), summary (la descripción de una línea que publica el gestor), issued_at, effective_at, published_in, subjects[] y topics[] (de qué trata, según la clasificación del gestor), amendments[] (normas posteriores que el gestor registra como adiciones, modificaciones o derogatorias de esta, cada una con su norm_id para consultarla), official_url y document_url.
Las normas más largas del gestor superan el millón de caracteres, así que el texto se lee por rangos: envía offset y limit, y luego pasa el next_offset de la respuesta como offset hasta que has_more sea falso. content es null en las pocas normas que el gestor publica sin cuerpo, y en aproximadamente una de cada siete cuyo texto no entrega.
Un id que el gestor no contiene devuelve found: false con HTTP 200, no un error. Eso incluye un id al que apunta el amendments[] de otra norma: el gestor a veces cita una norma que ya no publica.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.