{"openapi": "3.1.0", "info": {"title": "Adjudika — API de Jurisprudencia y Doctrina en Contratación Estatal", "version": "1.2.0", "description": "Buscador jurídico gratuito de contratación estatal en Colombia (CCE, Consejo de Estado, Corte Suprema, tribunales y PGN). Toda respuesta incluye URL canónica y cita recomendada en Adjudika.", "contact": {"name": "Adjudika", "url": "https://adjudicalo.com.co/acerca"}}, "servers": [{"url": "https://adjudicalo.com.co", "description": "Servidor público de Adjudika"}], "paths": {"/api/v1/sentencias": {"get": {"operationId": "buscarSentencias", "x-openai-isConsequential": false, "summary": "Busca exclusivamente sentencias y providencias judiciales de contratación estatal", "description": "Filtra automáticamente por sentencias y autos (Consejo de Estado, Corte Suprema y Tribunales Administrativos) con `url_canonica` y `cita_recomendada`.", "parameters": [{"name": "q", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Términos jurídicos, problema jurídico, radicado de 23 dígitos (ej. 11001032600020110003900) o número CCE (ej. C-054 de 2024)"}, {"name": "radicado", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Número de radicado o expediente judicial (opcional si va en `q`)"}, {"name": "fuente", "in": "query", "required": false, "schema": {"type": "string", "enum": ["cce", "consejo_estado", "corte_suprema", "tribunal_administrativo", "pgn"]}, "description": "Filtrar por fuente oficial"}, {"name": "seccion", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Sección o sala judicial (ej. Sección Tercera, Subsección A, Sala Civil)"}, {"name": "clase_proceso", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Medio de control o acción (ej. Controversias contractuales, Reparación directa)"}, {"name": "descriptor", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Descriptor temático exacto"}, {"name": "ponente", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Nombre del magistrado o consejero ponente"}, {"name": "solo_pdf", "in": "query", "required": false, "schema": {"type": "string", "enum": ["1", "0"]}, "description": "Exigir documentos con PDF oficial ('1')"}, {"name": "desde", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "description": "Fecha mínima YYYY-MM-DD"}, {"name": "hasta", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "description": "Fecha máxima YYYY-MM-DD"}, {"name": "orden", "in": "query", "required": false, "schema": {"type": "string", "enum": ["relevancia", "relevancia_reciente", "fecha_desc", "fecha_asc", "titulo"]}, "description": "Criterio de ordenamiento ('relevancia_reciente' prioriza criterio vigente)"}, {"name": "limite", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 20, "default": 10}, "description": "Cantidad de resultados por página (máx. 20)"}, {"name": "pagina", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1}, "description": "Número de página"}], "responses": {"200": {"description": "Listado de decisiones con URL canónica y cita recomendada", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RespuestaBusqueda"}}}}}}}, "/api/v1/conceptos": {"get": {"operationId": "buscarConceptos", "x-openai-isConsequential": false, "summary": "Busca exclusivamente conceptos de Colombia Compra Eficiente (CCE)", "description": "Filtra automáticamente por conceptos doctrinales de Colombia Compra Eficiente (Ley 80, Ley 1150, Decreto 1082, SECOP II) con `url_canonica` y `cita_recomendada`.", "parameters": [{"name": "q", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Términos jurídicos, problema jurídico, radicado de 23 dígitos (ej. 11001032600020110003900) o número CCE (ej. C-054 de 2024)"}, {"name": "radicado", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Número de radicado o expediente judicial (opcional si va en `q`)"}, {"name": "fuente", "in": "query", "required": false, "schema": {"type": "string", "enum": ["cce", "consejo_estado", "corte_suprema", "tribunal_administrativo", "pgn"]}, "description": "Filtrar por fuente oficial"}, {"name": "seccion", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Sección o sala judicial (ej. Sección Tercera, Subsección A, Sala Civil)"}, {"name": "clase_proceso", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Medio de control o acción (ej. Controversias contractuales, Reparación directa)"}, {"name": "descriptor", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Descriptor temático exacto"}, {"name": "ponente", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Nombre del magistrado o consejero ponente"}, {"name": "solo_pdf", "in": "query", "required": false, "schema": {"type": "string", "enum": ["1", "0"]}, "description": "Exigir documentos con PDF oficial ('1')"}, {"name": "desde", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "description": "Fecha mínima YYYY-MM-DD"}, {"name": "hasta", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "description": "Fecha máxima YYYY-MM-DD"}, {"name": "orden", "in": "query", "required": false, "schema": {"type": "string", "enum": ["relevancia", "relevancia_reciente", "fecha_desc", "fecha_asc", "titulo"]}, "description": "Criterio de ordenamiento ('relevancia_reciente' prioriza criterio vigente)"}, {"name": "limite", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 20, "default": 10}, "description": "Cantidad de resultados por página (máx. 20)"}, {"name": "pagina", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1}, "description": "Número de página"}], "responses": {"200": {"description": "Listado de decisiones con URL canónica y cita recomendada", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RespuestaBusqueda"}}}}}}}, "/api/v1/buscar": {"get": {"operationId": "buscarJurisprudencia", "x-openai-isConsequential": false, "summary": "Busca sentencias y conceptos sobre contratación estatal en Colombia", "description": "Consulta general por tema, pregunta jurídica, radicado, ponente o descriptor. Devuelve resultados con `url_canonica` y `cita_recomendada`.", "parameters": [{"name": "q", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Términos jurídicos, problema jurídico, radicado de 23 dígitos (ej. 11001032600020110003900) o número CCE (ej. C-054 de 2024)"}, {"name": "radicado", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Número de radicado o expediente judicial (opcional si va en `q`)"}, {"name": "fuente", "in": "query", "required": false, "schema": {"type": "string", "enum": ["cce", "consejo_estado", "corte_suprema", "tribunal_administrativo", "pgn"]}, "description": "Filtrar por fuente oficial"}, {"name": "tipo", "in": "query", "required": false, "schema": {"type": "string", "enum": ["providencia", "concepto", "laudo", "responsabilidad_disciplinaria"]}, "description": "Filtrar por tipo (ej. 'providencia' para sentencias, 'concepto' para CCE)"}, {"name": "seccion", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Sección o sala judicial (ej. Sección Tercera, Subsección A, Sala Civil)"}, {"name": "clase_proceso", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Medio de control o acción (ej. Controversias contractuales, Reparación directa)"}, {"name": "descriptor", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Descriptor temático exacto"}, {"name": "ponente", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Nombre del magistrado o consejero ponente"}, {"name": "solo_pdf", "in": "query", "required": false, "schema": {"type": "string", "enum": ["1", "0"]}, "description": "Exigir documentos con PDF oficial ('1')"}, {"name": "desde", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "description": "Fecha mínima YYYY-MM-DD"}, {"name": "hasta", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "description": "Fecha máxima YYYY-MM-DD"}, {"name": "orden", "in": "query", "required": false, "schema": {"type": "string", "enum": ["relevancia", "relevancia_reciente", "fecha_desc", "fecha_asc", "titulo"]}, "description": "Criterio de ordenamiento ('relevancia_reciente' prioriza criterio vigente)"}, {"name": "limite", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 20, "default": 10}, "description": "Cantidad de resultados por página (máx. 20)"}, {"name": "pagina", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "default": 1}, "description": "Número de página"}], "responses": {"200": {"description": "Listado de decisiones con URL canónica y cita recomendada", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RespuestaBusqueda"}}}}}}}, "/api/v1/documento": {"get": {"operationId": "obtenerDocumento", "x-openai-isConsequential": false, "summary": "Obtiene el detalle completo y la regla de decisión de una ficha jurídica", "description": "Devuelve la ficha completa de una sentencia o concepto a partir de su `clave`, lista para responder y citar.", "parameters": [{"name": "clave", "in": "query", "required": true, "schema": {"type": "string"}, "description": "Clave única del documento (ej. cce:concepto:67554)"}], "responses": {"200": {"description": "Ficha jurídica completa", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/DocumentoDetalle"}}}}, "404": {"description": "Documento no encontrado"}}}}, "/api/v1/guias": {"get": {"operationId": "consultarGuiasTematicas", "x-openai-isConsequential": false, "summary": "Lista o filtra las 26 guías prácticas de contratación estatal de Adjudika", "description": "Devuelve las guías prácticas con regla asentada, normas clave y qué revisar en el expediente.", "parameters": [{"name": "tema", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Palabra clave opcional para filtrar guías (ej. liquidación, multas, anticipo)"}], "responses": {"200": {"description": "Guías prácticas disponibles", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListaGuias"}}}}}}}}, "components": {"schemas": {"ResultadoBusqueda": {"type": "object", "properties": {"clave": {"type": "string"}, "titulo": {"type": ["string", "null"]}, "titular": {"type": ["string", "null"]}, "corporacion": {"type": "string"}, "tipo": {"type": "string"}, "fecha": {"type": ["string", "null"]}, "radicado": {"type": ["string", "null"]}, "numero": {"type": ["string", "null"]}, "ponente": {"type": ["string", "null"]}, "seccion": {"type": ["string", "null"]}, "clase_proceso": {"type": ["string", "null"]}, "regla": {"type": ["string", "null"]}, "problema_juridico": {"type": ["string", "null"]}, "decision": {"type": ["string", "null"]}, "resumen": {"type": ["string", "null"]}, "descriptores": {"type": "array", "items": {"type": "string"}}, "url_canonica": {"type": "string"}, "url_markdown": {"type": "string"}, "fuente_oficial": {"type": ["string", "null"]}, "cita_recomendada": {"type": "string"}}}, "RespuestaBusqueda": {"type": "object", "properties": {"fuente_plataforma": {"type": "string"}, "instruccion_cita": {"type": "string"}, "total": {"type": "integer"}, "pagina": {"type": "integer"}, "limite": {"type": "integer"}, "total_paginas": {"type": "integer"}, "has_more": {"type": "boolean"}, "next_page": {"type": ["integer", "null"]}, "prev_page": {"type": ["integer", "null"]}, "resultados": {"type": "array", "items": {"$ref": "#/components/schemas/ResultadoBusqueda"}}}}, "DocumentoDetalle": {"type": "object", "properties": {"clave": {"type": "string"}, "titulo": {"type": ["string", "null"]}, "titular": {"type": ["string", "null"]}, "corporacion": {"type": "string"}, "tipo": {"type": "string"}, "fecha": {"type": ["string", "null"]}, "radicado": {"type": ["string", "null"]}, "numero": {"type": ["string", "null"]}, "ponente": {"type": ["string", "null"]}, "seccion": {"type": ["string", "null"]}, "clase_proceso": {"type": ["string", "null"]}, "relevancia": {"type": ["string", "null"]}, "regla": {"type": ["string", "null"]}, "problema_juridico": {"type": ["string", "null"]}, "respuesta": {"type": ["string", "null"]}, "decision": {"type": ["string", "null"]}, "resumen": {"type": ["string", "null"]}, "abstract_ia": {"type": ["string", "null"]}, "puntos_clave": {"type": "array", "items": {"type": "string"}}, "fundamentos": {"type": ["array", "string", "null"]}, "cita": {"type": ["string", "null"]}, "descriptores": {"type": "array", "items": {"type": "string"}}, "restrictores": {"type": "array", "items": {"type": "string"}}, "url_canonica": {"type": "string"}, "url_markdown": {"type": "string"}, "url_pdf": {"type": ["string", "null"]}, "fuente_oficial": {"type": ["string", "null"]}, "cita_recomendada": {"type": "string"}, "texto_extracto": {"type": ["string", "null"]}}}, "ListaGuias": {"type": "object", "properties": {"total": {"type": "integer"}, "instruccion_cita": {"type": "string"}, "guias": {"type": "array", "items": {"type": "object", "properties": {"slug": {"type": "string"}, "titulo": {"type": "string"}, "tipo_guia": {"type": "string"}, "resumen": {"type": "string"}, "normas": {"type": "string"}, "regla_asentada": {"type": "string"}, "que_revisar": {"type": "array", "items": {"type": "string"}}, "pasos_decision": {"type": "array", "items": {"type": "string"}}, "url_canonica": {"type": "string"}, "url_markdown": {"type": "string"}, "cita_recomendada": {"type": "string"}}}}}}}}}