> ## 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.

# ICFES

> Resultados Saber 11 de 2010 a 2022, por colegio y por municipio y estrato: estudiantes y puntajes promedio, global y por área.

El Instituto Colombiano para la Evaluación de la Educación (ICFES) aplica Saber 11, el examen que presenta cada estudiante al terminar la educación media. Estos son sus resultados publicados de 2010 a 2022, agregados de dos formas: por colegio (cerca de 10.000 colegios por año), y por municipio y el estrato que los estudiantes reportaron para su hogar. Cada grupo trae cuántos estudiantes presentaron el examen, cada uno contado una vez, y su puntaje global promedio (0 a 500) y su puntaje promedio en matemáticas, lectura crítica, ciencias naturales, sociales y ciudadanas e inglés (0 a 100). El examen tomó su forma actual en la segunda aplicación de 2014: antes de ella solo se publican matemáticas e inglés, en la escala del examen anterior, y no hay puntaje global.

El ICFES ha publicado resultados hasta la segunda aplicación de 2022. Dos segundas aplicaciones faltan en lo que ha publicado, 2018-2 y 2021-2, así que esos periodos no devuelven nada.

Busca colegios por nombre, código DANE, municipio, periodo o sector; consulta el desglose por estrato por municipio, departamento, periodo o estrato.

<Note>
  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).
</Note>

## Buscar resultados por colegio

`POST /co/icfes/saber11-schools-search/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Una fila por colegio y periodo, del periodo más reciente al más antiguo y, dentro de cada uno, del mayor puntaje global promedio al menor.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el nombre del colegio y su municipio. |
| `school_code` | string | Código DANE opcional del colegio, 12 dígitos, p. ej. `111001000078`. |
| `territory_code` | string | Código DIVIPOLA opcional de la ubicación del colegio: 5 dígitos para un municipio (p. ej. `11001`, Bogotá), 2 dígitos para todo un departamento (p. ej. `05`). |
| `year` | integer | Año opcional del examen, 2010 a 2022. `0` devuelve todos los años. Por defecto `0`. |
| `period` | string | Periodo opcional: `yyyy-1` (primera aplicación) o `yyyy-2` (segunda aplicación), p. ej. `2022-2`. |
| `school_sector` | enum | Sector opcional: `oficial` o `no_oficial`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-100). Por defecto `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/icfes/saber11-schools-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "territory_code": "11001",
        "period": "2022-2",
        "school_sector": "oficial"
      }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` y `results[]`. Cada resultado incluye `id`, `period`, `year`, `sitting`, `school_code` (DANE), `school_name`, `school_sector` (`oficial` o `no_oficial`), `calendar`, `area`, `territory_code`, `territory_name`, `department_code`, `department_name`, `students` (cada estudiante contado una vez), `mean_global` (0 a 500), `mean_mathematics`, `mean_critical_reading`, `mean_natural_sciences`, `mean_social_studies` y `mean_english` (0 a 100 cada uno).

<Note>
  Compara lo comparable. La primera aplicación de cada año (`yyyy-1`) es pequeña y en su mayoría de colegios privados de calendario B, cuyos estudiantes puntúan muy por encima del promedio nacional; la segunda (`yyyy-2`) es casi todo el país. El estrato es el que cada estudiante reportó para su hogar, y en la segunda aplicación cerca de la mitad de quienes reportan estratos 5 y 6 estudian en colegios oficiales y puntúan muy por debajo de sus pares de colegios privados, así que los promedios de estratos 5 y 6 de un municipio pueden quedar por debajo del estrato 4.
</Note>

## Resultados por estrato

`POST /co/icfes/saber11-strata-search/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Una fila por municipio, estrato y periodo, del periodo más reciente al más antiguo.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional de la ubicación del colegio: 5 dígitos para un municipio (p. ej. `11001`, Bogotá), 2 dígitos para todo un departamento (p. ej. `05`). |
| `year` | integer | Año opcional del examen, 2010 a 2022. `0` devuelve todos los años. Por defecto `0`. |
| `period` | string | Periodo opcional: `yyyy-1` (primera aplicación) o `yyyy-2` (segunda aplicación), p. ej. `2022-2`. |
| `stratum` | enum | Estrato opcional: `1` a `6`, `sin_estrato` (el hogar no tiene) o `no_reportado` (sin respuesta). |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-100). Por defecto `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/icfes/saber11-strata-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "territory_code": "11001", "period": "2022-2" }'
```

Devuelve `as_of`, los filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` y `results[]`. Cada resultado incluye `id`, `period`, `year`, `sitting`, `territory_code`, `territory_name`, `department_code`, `department_name`, `stratum`, `students` (cada estudiante contado una vez), `mean_global` (0 a 500), `mean_mathematics`, `mean_critical_reading`, `mean_natural_sciences`, `mean_social_studies` y `mean_english` (0 a 100 cada uno).

<Note>
  Compara lo comparable. La primera aplicación de cada año (`yyyy-1`) es pequeña y en su mayoría de colegios privados de calendario B, cuyos estudiantes puntúan muy por encima del promedio nacional; la segunda (`yyyy-2`) es casi todo el país. El estrato es el que cada estudiante reportó para su hogar, y en la segunda aplicación cerca de la mitad de quienes reportan estratos 5 y 6 estudian en colegios oficiales y puntúan muy por debajo de sus pares de colegios privados, así que los promedios de estratos 5 y 6 de un municipio pueden quedar por debajo del estrato 4.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.