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

# MinEducación

> Indicadores de educação de cada município da Colômbia e cada ano desde 2011: cobertura, evasão, aprovação, reprovação e repetência, no total e por nível.

O Ministerio de Educación Nacional (MinEducación) publica, para cada um dos \~1.120 municípios da Colômbia e cada ano letivo desde 2011, os indicadores básicos da educação pré-escolar, fundamental e média: a população de 5 a 16 anos e quanto dela está matriculada, a cobertura líquida e bruta, e a proporção de alunos que evadem, são aprovados, reprovados ou repetem, no total e por nível (transición, primaria, secundaria, media). Cerca de 15.700 municípios-ano.

Filtre pelo código DIVIPOLA de um município ou de um departamento, por ano ou por nome.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

`POST /co/mineducacion/indicators-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma linha por município e ano, do ano mais recente ao mais antigo.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas nos nomes do município e do departamento. |
| `territory_code` | string | Código DIVIPOLA opcional: 5 dígitos para um município (p. ex. `05001`, Medellín), 2 dígitos para todos os municípios de um departamento (p. ex. `05`). |
| `year` | integer | Ano letivo opcional, desde 2011. `0` retorna todos os anos. Por padrão `0`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-100). Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/mineducacion/indicators-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "territory_code": "05001" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `results[]`. Cada resultado traz `id`, `year`, `territory_code` e `territory_name` (o município), `department_code`, `department_name`, `certified_entity_code` e `certified_entity_name` (a entidade territorial certificada, ETC, que administra suas escolas públicas), `population_5_16`, `enrollment_rate_5_16` e seis indicadores, cada um com `total`, `transition`, `primary`, `lower_secondary` e `upper_secondary`, em porcentagem: `net_coverage`, `gross_coverage`, `dropout` (evasão), `approval` (aprovação), `failure` (reprovação) e `repetition` (repetência). `average_group_size` e `schools_with_internet` só são publicados de 2011 a 2017.

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>


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