> ## Documentation Index > Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt > Use this file to discover all available pages before exploring further. # SAMAI Relatoría > Busca en todas las providencias del Consejo de Estado desde diciembre de 2021 por su titulación, texto completo, sección, tipo, ponente, partes o fecha, y lee cualquiera con su texto completo y su documento. La relatoría del Consejo de Estado titula cada providencia que publica en SAMAI: sentencias, autos, aclaraciones y salvamentos de voto y conceptos, cada una con su titulación (descriptores del tesauro, el problema jurídico y su respuesta, la tesis, las fuentes formales y las notas de la relatoría). Cada providencia fechada desde diciembre de 2021 llega aquí con esa titulación, el texto completo, el documento y un enlace al proceso en el sitio de la corporación. Busca en todas a la vez, por sección, tipo, año, radicado, ponente, partes o fecha, o con texto libre que llega hasta la titulación y el cuerpo de cada providencia. Busca primero y luego lee una providencia completa. 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](/es/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. | Campo | Tipo | Notas | | --------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `query` | string | Palabras opcionales que se buscan en la titulación (descriptores, problema jurídico, tesis, fuentes, nota de relatoría), el radicado, las partes y el texto completo. | | `chamber` | string | Sección o sala opcional, comparada desde el inicio del nombre: `Sección Tercera` también trae sus subsecciones, `Sala de Consulta`. No importan mayúsculas ni tildes. | | `type` | string | Tipo de providencia opcional, comparado desde el inicio del nombre: `Sentencia`, `Auto` (todos los autos), `Salvamento voto`, `Aclaración voto`. No importan mayúsculas ni tildes. | | `year` | integer | Año opcional de la fecha de la providencia. 0 busca en todos los años. Por defecto `0`. | | `registration_number` | string | Radicado opcional de 23 dígitos. No importan espacios, puntos ni guiones. | | `reporting_judge` | string | Consejero ponente opcional, por su nombre completo como aparece en `reporting_judges`. No importan mayúsculas ni tildes. | | `plaintiff` | string | Demandante opcional, comparado desde el inicio del nombre como lo registra la corporación. No importan mayúsculas ni tildes. | | `defendant` | string | Demandado opcional, comparado desde el inicio del nombre como lo registra la corporación. No importan mayúsculas ni tildes. | | `from_date` | string | Opcional: solo providencias proferidas en esta fecha o después, `yyyy-mm-dd`. | | `to_date` | string | Opcional: solo providencias proferidas en esta fecha o antes, `yyyy-mm-dd`. | | `page` | integer | Número de página, empieza en 1. Por defecto `1`. | | `per_page` | integer | Resultados por página (1-50). Por defecto `20`. | ```bash theme={"dark"} curl https://api.croma.run/co/samai-rulings/search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "reparación directa", "chamber": "Sección Tercera" }' ``` 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 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 | Campo | Tipo | Notas | | ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `ruling_id` | string | **Obligatorio.** El `id` de la providencia en un resultado de búsqueda: el certificado hexadecimal de 64 caracteres de su documento. No importan mayúsculas. | | `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. | | `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de las providencias caben en una sola respuesta. Por defecto `200000`. | ```bash theme={"dark"} curl https://api.croma.run/co/samai-rulings/ruling/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "ruling_id": "8C5E75723C249F020E54B1D2B2BCB0735566D537789B23F23B1373B33F24F21F" }' ``` Devuelve `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. Esquemas, todos los campos de respuesta y un playground interactivo.