---
title: "Georgia Office of Student Achievement (GOSA) Retained K-12 dataset"
method: GET
path: "/api/v1/education/retained_students"
tags: ["education"]
---

# Georgia Office of Student Achievement (GOSA) Retained K-12 dataset

`GET /api/v1/education/retained_students`

## Request

- Base URL: `https://georgiacivicdata.org`
- URL: `https://georgiacivicdata.org/api/v1/education/retained_students`
- Auth: none declared

Georgia Office of Student Achievement (GOSA) Retained K-12 dataset. For every Georgia public school, school district, and the state as a whole, reports the total number of students retained (held back) in grades K-12 during the school year, the total K-12 enrollment (2011 onward only), and a demographic breakdown of the retained population — counts and shares of retained by race and gender. The race axis carries six canonical codes (`native_american`, `asian_pacific_islander` — the bronze `Asian`/`Asians` label is a combined Asian/Pacific Islander bucket, with no separate Pacific Islander row — `black`, `hispanic`, `multiracial`, `white`); gender is `male`/`female`. Coverage spans the 2003-04 school year (filename year 2004) through the 2023-24 school year (filename year 2024) — 21 files.

**Filterable categorical columns:** none

**Detail levels available:** districts, schools, states (default: `schools`)

**Year coverage:** 2004–2024 (21 years, no gaps)

**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.

**Source:** Governor's Office of Student Achievement (GOSA)

## Query parameters

- `year` integer, nullable: Exact year
- `year_min` integer, nullable: Inclusive lower bound
- `year_max` integer, nullable: Inclusive upper bound
- `district_code` string, nullable: Comma-separated list of GOSA district codes (e.g. `601,602`)
- `school_code` string, nullable: Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.
- `county_fips` string, nullable: Comma-separated list of 5-digit county FIPS codes (e.g. `13121,13067`)
- `tract_geoid` string, nullable: Comma-separated list of 11-digit census tract GEOIDs (e.g. `13121011100`)
- `block_group_geoid` string, nullable: Comma-separated list of 12-digit census block group GEOIDs (e.g. `131210111001`)
- `demographic` string, nullable: Comma-separated demographic codes (e.g. `all,black,hispanic`)
- `detail` string, nullable: Detail level (whatever the topic publishes — e.g. schools, districts, counties, or states).
- `limit` integer, nullable: Page size
- `offset` integer: Page offset
- `columns` string, nullable: Comma-separated output columns to return (fact columns plus joined dimension attributes). Defaults to all.
- `format` 'json' | 'csv' | 'parquet': Response format: json | csv | parquet

## Response `200`

Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/georgiacivicdata/apis/georgia-civic-data-api.md) · [All operations](https://skmtc.dev/georgiacivicdata/apis/georgia-civic-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/georgiacivicdata/apis/georgia-civic-data-api/revisions/dcfdf19662d2?raw)