La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye
as_of: qué tan actualizados están los datos. Cómo funcionan los datasets.Buscar providencias
POST /co/samai-rulings/search/v1 Dataset
Una sola búsqueda sobre la titulación y el texto completo de todas las providencias del Consejo de Estado desde diciembre de 2021, filtrada por sección, tipo, año, radicado, ponente, partes o fecha.
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 providencia más reciente a la más antigua. Cada resultado incluye id (el certificado de 64 caracteres del documento de la providencia), registration_number (el radicado de 23 dígitos; un proceso agrupa varias providencias), internal_number, chamber y chamber_key, type y type_key, proceeding_class (el medio de control), action, ruling_date, filing_date (cuando el proceso llegó al Consejo de Estado), year, reporting_judges[] y reporting_judge_keys[], plaintiff y defendant con sus variantes *_key, la titulación de la relatoría (descriptors[], legal_problem, legal_problem_answer, thesis, formal_sources[], relatoria_note, y headnotes[] con cada titulación por separado), text_status, document_format, document_url (el documento de la providencia, PDF, o Word en algunas de las más antiguas, siempre disponible) y official_url (la página del proceso en el sitio del Consejo de Estado).
Los resultados de búsqueda no incluyen el texto de la providencia.
query sí busca dentro de él, así que una frase del cuerpo encuentra la providencia; para leer el texto usa el endpoint SAMAI Ruling.Una providencia, completa
POST /co/samai-rulings/ruling/v1 Dataset
as_of, found, ruling_id y ruling, que trae todo lo que devuelve la búsqueda más content: una ventana sobre el texto completo de la providencia, con text, offset, total_length, has_more y next_offset. Cada resultado incluye id (el certificado de 64 caracteres del documento de la providencia), registration_number (el radicado de 23 dígitos; un proceso agrupa varias providencias), internal_number, chamber y chamber_key, type y type_key, proceeding_class (el medio de control), action, ruling_date, filing_date (cuando el proceso llegó al Consejo de Estado), year, reporting_judges[] y reporting_judge_keys[], plaintiff y defendant con sus variantes *_key, la titulación de la relatoría (descriptors[], legal_problem, legal_problem_answer, thesis, formal_sources[], relatoria_note, y headnotes[] con cada titulación por separado), text_status, document_format, document_url (el documento de la providencia, PDF, o Word en algunas de las más antiguas, siempre disponible) y official_url (la página del proceso en el sitio del Consejo de Estado).
Las providencias largas llegan a decenas de miles 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 cuando text_status no es extracted; document_url sigue teniendo el documento.Un
id que no está en la relatoría devuelve found: false con HTTP 200, no un error. La relatoría titula una providencia semanas o meses después de proferida, así que una reciente puede dar found: false hoy y aparecer después.Referencia completa
Esquemas, todos los campos de respuesta y un playground interactivo.