--- title: "MinEducación Municipal Education Indicators" method: POST path: "/co/mineducacion/indicators-search/v1" tags: ["Colombia", "MinEducación"] --- # MinEducación Municipal Education Indicators `POST /co/mineducacion/indicators-search/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/co/mineducacion/indicators-search/v1` - Auth: HTTP bearer Education indicators of Colombia's Ministry of Education for every municipality and school year since 2011 (about 15,700 municipality-years): population aged 5 to 16, enrollment rate, net and gross coverage, dropout, approval, failure and repetition, overall and by level (transición, primaria, secundaria, media), in percent. Filter by `territory_code` (5-digit DIVIPOLA municipality or 2-digit department), `year`, or match municipality and department names with `query`. Newest year first. Served by Croma (`as_of` says how current the data is). **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. ## Headers - `Idempotency-Key` string ## Request body - object - `query` string: Optional words matched against the municipality and department names. - `territory_code` string: Optional DIVIPOLA code: 5 digits for one municipality (e.g. `05001`, Medellín) or 2 digits for every municipality of a department (e.g. `05`, Antioquia). - `year` integer: Optional school year, from 2011. 0 returns every year. - `page` integer: 1-based page number for paginated results. - `per_page` integer: Results per page (1-100). ## Response `200` Successful response - MineducacionIndicatorsSearchResponse - `data` MineducacionIndicatorsSearchData, required - `as_of` string, nullable, required: How current the data in this response is. - `query` string, required - `territory_code` string, nullable, required - `year` number, nullable, required - `total` number, required - `page` number, required - `per_page` number, required - `total_pages` number, required - `count` number, required - `results` object[], required - `id` string, required: The year and the municipality's DIVIPOLA code, e.g. `2024-05001`. - `year` number, required: The school year the figures describe. - `territory_code` string, required: The municipality's 5-digit DIVIPOLA code, e.g. `05001`. - `territory_name` string, nullable, required: The municipality's name, e.g. `Medellín`. - `department_code` string, required: The department's 2-digit DIVIPOLA code, e.g. `05`. - `department_name` string, nullable, required: The department's name, e.g. `Antioquia`. - `certified_entity_code` string, nullable, required: The code of the certified territorial entity (entidad territorial certificada, ETC) that runs the municipality's public schools. - `certified_entity_name` string, nullable, required: The certified territorial entity's name, e.g. `Antioquia (ETC)` or `Medellín`. - `population_5_16` number, nullable, required: The municipality's population aged 5 to 16, as the Ministry projects it. - `enrollment_rate_5_16` number, nullable, required: Children aged 5 to 16 enrolled, over the population of that age, in percent. - `net_coverage` object, required: Net coverage: pupils of the official age for the level, over the population of that age, overall and by level, in percent. A level is null where the Ministry publishes nothing for it. - `total` number, nullable, required: Net coverage: pupils of the official age for the level, over the population of that age across preschool, primary and secondary, in percent. - `transition` number, nullable, required: Net coverage: pupils of the official age for the level, over the population of that age in transición (the last year of preschool), in percent. - `primary` number, nullable, required: Net coverage: pupils of the official age for the level, over the population of that age in primaria, in percent. - `lower_secondary` number, nullable, required: Net coverage: pupils of the official age for the level, over the population of that age in secundaria (grades 6 to 9), in percent. - `upper_secondary` number, nullable, required: Net coverage: pupils of the official age for the level, over the population of that age in media (grades 10 and 11), in percent. - `gross_coverage` object, required: Gross coverage: every pupil in the level, whatever the age, over the population of the official age (can exceed 100), overall and by level, in percent. A level is null where the Ministry publishes nothing for it. - `total` number, nullable, required: Gross coverage: every pupil in the level, whatever the age, over the population of the official age (can exceed 100) across preschool, primary and secondary, in percent. - `transition` number, nullable, required: Gross coverage: every pupil in the level, whatever the age, over the population of the official age (can exceed 100) in transición (the last year of preschool), in percent. - `primary` number, nullable, required: Gross coverage: every pupil in the level, whatever the age, over the population of the official age (can exceed 100) in primaria, in percent. - `lower_secondary` number, nullable, required: Gross coverage: every pupil in the level, whatever the age, over the population of the official age (can exceed 100) in secundaria (grades 6 to 9), in percent. - `upper_secondary` number, nullable, required: Gross coverage: every pupil in the level, whatever the age, over the population of the official age (can exceed 100) in media (grades 10 and 11), in percent. - `dropout` object, required: Intra-annual dropout (deserción): pupils who left during the year, overall and by level, in percent. A level is null where the Ministry publishes nothing for it. - `total` number, nullable, required: Intra-annual dropout (deserción): pupils who left during the year across preschool, primary and secondary, in percent. - `transition` number, nullable, required: Intra-annual dropout (deserción): pupils who left during the year in transición (the last year of preschool), in percent. - `primary` number, nullable, required: Intra-annual dropout (deserción): pupils who left during the year in primaria, in percent. - `lower_secondary` number, nullable, required: Intra-annual dropout (deserción): pupils who left during the year in secundaria (grades 6 to 9), in percent. - `upper_secondary` number, nullable, required: Intra-annual dropout (deserción): pupils who left during the year in media (grades 10 and 11), in percent. - `approval` object, required: Approval (aprobación): pupils who passed the year, overall and by level, in percent. A level is null where the Ministry publishes nothing for it. - `total` number, nullable, required: Approval (aprobación): pupils who passed the year across preschool, primary and secondary, in percent. - `transition` number, nullable, required: Approval (aprobación): pupils who passed the year in transición (the last year of preschool), in percent. - `primary` number, nullable, required: Approval (aprobación): pupils who passed the year in primaria, in percent. - `lower_secondary` number, nullable, required: Approval (aprobación): pupils who passed the year in secundaria (grades 6 to 9), in percent. - `upper_secondary` number, nullable, required: Approval (aprobación): pupils who passed the year in media (grades 10 and 11), in percent. - `failure` object, required: Failure (reprobación): pupils who did not pass the year, overall and by level, in percent. A level is null where the Ministry publishes nothing for it. - `total` number, nullable, required: Failure (reprobación): pupils who did not pass the year across preschool, primary and secondary, in percent. - `transition` number, nullable, required: Failure (reprobación): pupils who did not pass the year in transición (the last year of preschool), in percent. - `primary` number, nullable, required: Failure (reprobación): pupils who did not pass the year in primaria, in percent. - `lower_secondary` number, nullable, required: Failure (reprobación): pupils who did not pass the year in secundaria (grades 6 to 9), in percent. - `upper_secondary` number, nullable, required: Failure (reprobación): pupils who did not pass the year in media (grades 10 and 11), in percent. - `repetition` object, required: Repetition (repitencia): pupils repeating the grade they were in the year before, overall and by level, in percent. A level is null where the Ministry publishes nothing for it. - `total` number, nullable, required: Repetition (repitencia): pupils repeating the grade they were in the year before across preschool, primary and secondary, in percent. - `transition` number, nullable, required: Repetition (repitencia): pupils repeating the grade they were in the year before in transición (the last year of preschool), in percent. - `primary` number, nullable, required: Repetition (repitencia): pupils repeating the grade they were in the year before in primaria, in percent. - `lower_secondary` number, nullable, required: Repetition (repitencia): pupils repeating the grade they were in the year before in secundaria (grades 6 to 9), in percent. - `upper_secondary` number, nullable, required: Repetition (repitencia): pupils repeating the grade they were in the year before in media (grades 10 and 11), in percent. - `average_group_size` number, nullable, required: Pupils per class group, on average. Published from 2011 to 2017 only. - `schools_with_internet` number, nullable, required: Share of school sites (sedes) with an internet connection, in percent. Published from 2011 to 2017 only. ## Other responses - `400`: Invalid request body - `401`: Missing or invalid API key - `429`: Rate limit exceeded - `500`: Internal error - `502`: Upstream source returned an error --- [API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)