{"openapi":"3.1.0","info":{"title":"Georgia Civic Data API","description":"Read-only REST API serving cleaned, standardized public data for the state of Georgia. v1 covers the **education** domain, driven entirely by git-tracked [ODCS](https://bitol-io.github.io/open-data-contract-standard/) data contracts — so every dataset's columns, units, ranges, and allowed values are stable and documented.\n\n**Base path:** all data routes live under `/api/v1`.\n\n**Discover, don't hard-code.** `GET /api/v1/datasets` lists every dataset; `GET /api/v1/datasets/{main}/{topic}` returns a dataset's full schema (columns, filters, ranges, allowed values) as JSON; `.../contract?format=yaml` returns the raw contract.\n\n**Note on filters:** each dataset's fact route accepts one filter parameter per categorical column (plus year / detail / FK filters). Because routes are generated per dataset, these per-column filters are **not** enumerated in this OpenAPI schema. For the complete, machine-readable filter surface use each dataset's schema/contract endpoint, the human docs at https://georgiacivicdata.org/api, or the agent reference at https://georgiacivicdata.org/llms-full.txt.","contact":{"name":"Georgia Civic Data","url":"https://georgiacivicdata.org/api","email":"shane@georgiacivicdata.org"},"license":{"name":"Open Data Commons Attribution License (ODC-By) 1.0","url":"https://opendatacommons.org/licenses/by/1-0/"},"version":"0.1.0"},"servers":[{"url":"https://georgiacivicdata.org","description":"Production (brand domain, same-origin proxy)"},{"url":"https://georgia-civic-data-production.up.railway.app","description":"Production (origin)"}],"paths":{"/":{"get":{"tags":["meta"],"summary":"Service info / root","description":"Tiny landing pointer so the bare URL is useful, not a 404.","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/healthz":{"get":{"tags":["meta"],"summary":"Liveness probe + registry status","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/datasets":{"get":{"tags":["meta"],"summary":"List all approved topics","description":"Returns one summary entry per approved topic, including detail levels, year range, and the per-topic endpoint URL.","operationId":"list_datasets_api_v1_datasets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/datasets/{main_topic}/{topic}":{"get":{"tags":["meta"],"summary":"Get full schema for one topic","description":"Returns the topic's columns (name, type, role, validValues, description) plus discovery metadata.","operationId":"get_dataset_api_v1_datasets__main_topic___topic__get","parameters":[{"name":"main_topic","in":"path","required":true,"schema":{"type":"string","title":"Main Topic"}},{"name":"topic","in":"path","required":true,"schema":{"type":"string","title":"Topic"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/datasets/{main_topic}/{topic}/contract":{"get":{"tags":["meta"],"summary":"Get a topic's raw ODCS data contract","description":"Returns the authoritative ODCS v3.1 data contract for one topic so agents and clients can consume the machine-readable schema without cloning the repo. `?format=yaml` (default) returns the contract document verbatim; `?format=json` returns it parsed as JSON.","operationId":"get_dataset_contract_api_v1_datasets__main_topic___topic__contract_get","parameters":[{"name":"main_topic","in":"path","required":true,"schema":{"type":"string","title":"Main Topic"}},{"name":"topic","in":"path","required":true,"schema":{"type":"string","title":"Topic"}},{"name":"format","in":"query","required":false,"schema":{"enum":["yaml","json"],"type":"string","description":"Contract serialization: yaml | json","default":"yaml","title":"Format"},"description":"Contract serialization: yaml | json"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/_dimensions/{name}/schema":{"get":{"tags":["education","dimensions"],"summary":"Get a dimension's schema","description":"Returns the dimension's machine-readable schema: columns (name, type, role, nullable, description, primary-key position, valid values), the ordered primary key, the attribute columns a join attaches, and — when present — cross-dataset `link_keys` (districts) and `semantics` (demographics).","operationId":"read_dimension_schema_api_v1_education__dimensions__name__schema_get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/_dimensions/{name}":{"get":{"tags":["education","dimensions"],"summary":"Read a dimension table","description":"Paginated read of a dimension parquet. Names come from the loaded dimension contracts (e.g. `districts`, `schools`, `demographics`).","operationId":"read_dimension_api_v1_education__dimensions__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/ccrpi_climate_star_rating":{"get":{"tags":["education"],"summary":"Georgia public schools' School Climate Star Rating (CCRPI) from Georgia Insights / GaDOE: an ordinal 1-5 whole-star rati","description":"Georgia public schools' School Climate Star Rating (CCRPI) from Georgia Insights / GaDOE: an ordinal 1-5 whole-star rating built from four equally weighted components (climate surveys, student discipline, safe & substance-free environment, school-wide attendance), published 2014-2019 and 2024. School-level only — the source publishes no district or state aggregate rows — with no demographic breakdowns. Years 2020-2023 are absent (Georgia paused CCRPI during COVID). The CCRPI Single Score that GaDOE paired with this rating is not carried here; it lives in the `ccrpi_scoring_by_component` topic.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** schools (default: `schools`)\n\n**Year coverage:** 2014–2024 (no data for: 2020, 2021, 2022, 2023)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_ccrpi_climate_star_rating_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/ccrpi_content_mastery":{"get":{"tags":["education"],"summary":"CCRPI Content Mastery measures student proficiency on Georgia state assessments in core academic subjects at the school,","description":"CCRPI Content Mastery measures student proficiency on Georgia state assessments in core academic subjects at the school, district, and (2014+) state level, broken out by demographic subgroup, grade cluster, and (2012-2017) assessment type. The primary `indicator_score` metric unifies four source labels across eras: Meets & Exceeds Rate (2012-2014, CRCT/EOCT), Weighted Proficiency Rate (2015-2017, EOG/EOC; exceeds 100 by design), Indicator Score (2018-2019, 2022-2025), and Achievement Rate (2021). 2021-2022 add four learner-band proportions with derived `_or_above` cumulatives; 2018-2019 and 2023-2025 add an improvement `indicator_target` and a color `ccrpi_flag`. 2020 is absent — Georgia paused CCRPI during COVID. This is the deep-dive into the Content Mastery component only (by demographic, subject, and assessment type); the overall CCRPI score and the side-by-side scorecard of all five rolled-up component scores live in the `ccrpi_scoring_by_component` topic (the CCRPI overview), which this topic does not duplicate.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_cluster` — one of: `elementary`, `high`, `middle`\n- `assessment_type` — one of: `crct`, `eoc`, `eoct`, `eog`\n- `subject` — one of: `9th_grade_literature_and_composition`, `algebra_i_coordinate_algebra`, `american_literature_and_composition`, `biology`, `economics_business_free_enterprise`, `english_language_arts`, `geometry_analytic_geometry`, `mathematics`, `mathematics_1`, `mathematics_2`, `physical_science`, `reading`, `science`, `social_studies`, `us_history`\n- `ccrpi_flag` — one of: `green`, `green_star`, `red`, `yellow`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2012–2025 (no data for: 2020)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_ccrpi_content_mastery_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/ccrpi_graduation_rate":{"get":{"tags":["education"],"summary":"Georgia high school graduation rates at the school, district, and state level by demographic subgroup, 2012-2025","description":"Georgia high school graduation rates at the school, district, and state level by demographic subgroup, 2012-2025. A single `graduation_rate` column (0-1 scale) carries three distinct methodologies discriminated by `rate_type`: the federal adjusted 4-year cohort rate (2012-2025), the 5-year cohort variant (2018-2024), and the Senate Bill 431 on-time rate (2021-2024, school-level only). `num_cohort` and `num_graduates` carry the published denominator/numerator where a source ships them; CCRPI accountability years add an improvement `indicator_target` and color `ccrpi_flag`. Sources span six release families (CCRPI workbooks, legacy 2012-2014 releases, standalone 4-year and 5-year cohort releases, SB 431 on-time releases, and a GOSA-portal CSV that fills the 2023 4-year count gap), merged by source precedence. This topic publishes the underlying graduation rates by methodology and demographic; the CCRPI Graduation Rate component score as it feeds the accountability index (a distinct benchmarked value, not equal to the raw 4-year rate) — alongside the overall CCRPI score and the other four component scores — lives in the `ccrpi_scoring_by_component` topic (the CCRPI overview).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `rate_type` — one of: `4_year`, `5_year`, `on_time`\n- `ccrpi_flag` — one of: `green`, `red`, `yellow`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2012–2025 (14 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE) / GOSA","operationId":"query_topic_api_v1_education_ccrpi_graduation_rate_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/ccrpi_progress":{"get":{"tags":["education"],"summary":"Georgia Insights (GaDOE) CCRPI Progress component","description":"Georgia Insights (GaDOE) CCRPI Progress component. Measures the rate at which students improve year-over-year on Georgia Milestones assessments (English Language Arts and Mathematics) and the rate at which English Learners progress toward English Language Proficiency (ELP), for every Georgia public school, school district, and the state. Reports a 0-100 `indicator_score` plus, where published, a 0-100 improvement `indicator_target` and a green/yellow/red `ccrpi_flag`, per grade cluster (elementary/middle/high), demographic subgroup, and indicator. 2020 is ELP-only (the only component GaDOE published that year). For 2021 and 2022 GaDOE published only the ELP component in a band-movement schema: four Era-B-only `pct_*` proportion columns partition English Learners by ELP band movement, and the composite ELP rate continues the `indicator_score` series. Coverage: 2018-2025, 8 files, no gap years. This is the deep-dive into the CCRPI Progress component only (by demographic and indicator); the overall CCRPI score and the side-by-side scorecard of all five rolled-up component scores — including the rolled-up Progress component score — live in the `ccrpi_scoring_by_component` topic (the CCRPI overview).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_cluster` — one of: `elementary`, `high`, `middle`\n- `indicator` — one of: `english_language_arts_growth`, `mathematics_growth`, `progress_towards_elp`\n- `ccrpi_flag` — one of: `green`, `red`, `yellow`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2018–2025 (8 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_ccrpi_progress_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/ccrpi_readiness":{"get":{"tags":["education"],"summary":"Georgia Insights (GaDOE) CCRPI Readiness component","description":"Georgia Insights (GaDOE) CCRPI Readiness component. Reports each Georgia public school's (and aggregated district / state) 0-100 score on the CCRPI Readiness indicators, per grade cluster (elementary/middle/high) and demographic subgroup. Six indicators vary by grade cluster: Literacy / At or Above Grade-Level Reading (E/M/H), Student Attendance / Attendance (E/M/H), Beyond the Core (E/M enrichment-course enrollment), Accelerated Enrollment (H college-level credit: AP, Dual Enrollment, IB, Advanced Academic, Cambridge), Pathway Completion (H), and College and Career Readiness (H). From 2021 the source adds a sub-indicator axis breaking each indicator into its components, plus an unbenchmarked participation rate for Accelerated Enrollment. Coverage: 2018-2019 and 2021-2025 (no 2020 — CCRPI was not calculated under the COVID federal waiver). This is the deep-dive into the CCRPI Readiness component only (by demographic, indicator, and sub-indicator); the overall CCRPI score and the side-by-side scorecard of all five rolled-up component scores — including the rolled-up Readiness component score — live in the `ccrpi_scoring_by_component` topic (the CCRPI overview).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_cluster` — one of: `elementary`, `high`, `middle`\n- `indicator` — one of: `accelerated_enrollment`, `at_or_above_grade_level_reading`, `attendance`, `beyond_the_core`, `college_and_career_readiness`, `literacy`, `pathway_completion`, `student_attendance`\n- `sub_indicator` — one of: `act_sat_ap_ib_cambridge`, `advanced_academic`, `advanced_placement`, `all`, `asvab`, `cambridge`, `career_exploratory`, `computer_science`, `ctae`, `dual_enrollment`, `eopa`, `fine_arts`, `international_baccalaureate`, `physical_education_health`, `tcsg_usg`, `work_based_learning`, `world_language`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2018–2025 (no data for: 2020)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_ccrpi_readiness_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/ccrpi_scoring_by_component":{"get":{"tags":["education"],"summary":"Components of Georgia's College and Career Ready Performance Index (CCRPI) accountability score at the school, district,","description":"Components of Georgia's College and Career Ready Performance Index (CCRPI) accountability score at the school, district, and state level by grade cluster (elementary / middle / high), 2012-2025 (no 2020-2021 — COVID pause). The metric set evolves across four source eras: 2012-2017 publish CCRPI component POINTS on per-component scales (achievement, progress, achievement gap, ED/EL/SWD performance, ETB and challenge bonus points); 2018+ publish five component SCORES on a 0-100 scale (content mastery, progress, closing gaps, readiness, graduation rate). The aggregated ccrpi_score and ccrpi_single_score accompany 2012-2019 (suppressed for 2022, dropped at source from 2023). Points-era and score-era metrics are different measurements on different scales — each column is populated only in its source era and the two families are NOT comparable. No demographic breakdown. This is the CCRPI OVERVIEW / SCORECARD topic — the most important CCRPI entry point and the only single-query view of a school's accountability picture: the SOLE source of the overall ccrpi_single_score and the per-cluster ccrpi_score, the only topic presenting all five component scores side by side, and the only home of the 2012-2017 points-era breakdown. It differs from the per-component topics (ccrpi_content_mastery, ccrpi_progress, ccrpi_readiness, ccrpi_graduation_rate) by being WIDE and SHALLOW — one rolled-up score per component at the all-student / grade-cluster grain, with no demographic, subject, indicator, or sub-indicator axis. Those topics are the complementary NARROW and DEEP view, each drilling a single component down by demographic and sub-measure but publishing neither the overall score nor the cross-component scorecard. Use this topic for the headline score and the component scorecard; use a component topic for within-component detail.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_cluster` — one of: `elementary`, `high`, `middle`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2012–2025 (no data for: 2020, 2021)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_ccrpi_scoring_by_component_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/enrollment_march_gender_race_ethnicity":{"get":{"tags":["education"],"summary":"Georgia Insights (GaDOE) FTE Enrollment by Race/Ethnicity and Gender — the March Cycle 3 FTE headcount of Georgia public","description":"Georgia Insights (GaDOE) FTE Enrollment by Race/Ethnicity and Gender — the March Cycle 3 FTE headcount of Georgia public school students, cross-classified by gender and by seven mutually exclusive race/ethnicity buckets (Hispanic, American Indian, Asian, Black, Pacific Islander, White, Two or more Races), for every school, district, and the state, fiscal years 2010-2025. This is the spring snapshot; the companion topic enrollment_october_gender_race_ethnicity reports the October Cycle 1 count. Source gender `Total` rows are dropped (redundant with Female + Male).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `race` — one of: `asian`, `black`, `hispanic`, `multiracial`, `native_american`, `pacific_islander`, `white`\n- `gender` — one of: `female`, `male`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2010–2025 (16 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_enrollment_march_gender_race_ethnicity_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/enrollment_october_disability":{"get":{"tags":["education"],"summary":"Georgia Insights (GaDOE) FTE Enrollment by Disability — the October Cycle 1 FTE headcount of Georgia public school stude","description":"Georgia Insights (GaDOE) FTE Enrollment by Disability — the October Cycle 1 FTE headcount of Georgia public school students receiving special-education services, broken out by the 17 GaDOE/IDEA disability categories (autism, specific learning disability, speech-language impairment, etc.) at the school-district level, fiscal years 2014-2026. District-only: the source publishes no state aggregate and no school-level rows. Counts below 10 are suppressed to NULL by the source's small-cell rule.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts (default: `districts`)\n\n**Year coverage:** 2014–2026 (13 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_enrollment_october_disability_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/enrollment_october_gender_race_ethnicity":{"get":{"tags":["education"],"summary":"Georgia Insights (GaDOE) FTE Enrollment by Race/Ethnicity and Gender — the October Cycle 1 FTE headcount of Georgia publ","description":"Georgia Insights (GaDOE) FTE Enrollment by Race/Ethnicity and Gender — the October Cycle 1 FTE headcount of Georgia public school students, cross-classified by gender and by seven mutually exclusive race/ethnicity buckets (Hispanic, American Indian, Asian, Black, Pacific Islander, White, Two or more Races), for every school, district, and the state, fiscal years 2010-2026. This is the fall snapshot; the companion topic enrollment_march_gender_race_ethnicity reports the March Cycle 3 count. Source gender `Total` rows are dropped (redundant with Female + Male).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `race` — one of: `asian`, `black`, `hispanic`, `multiracial`, `native_american`, `pacific_islander`, `white`\n- `gender` — one of: `female`, `male`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2010–2026 (17 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_enrollment_october_gender_race_ethnicity_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/free_reduced_lunch":{"get":{"tags":["education"],"summary":"Georgia Insights (GaDOE) Free and Reduced Price Meal Eligibility — the share of K-12 enrolled students eligible for Free","description":"Georgia Insights (GaDOE) Free and Reduced Price Meal Eligibility — the share of K-12 enrolled students eligible for Free or Reduced-price Lunch (FRL) under the USDA National School Lunch Program, for every Georgia public school, district/system, and the state, fiscal years 2013-2026. A widely used proxy for student economic disadvantage. Eligibility is income-based per the USDA Federal Income Eligibility Guidelines: free meals at or below 130% of the federal poverty level, reduced-price between 130% and 185%; the combined FRL rate counts students up to the 185% threshold. This is the broad income/application-based eligibility measure — the automatic categorical-eligibility SUBSET (students certified without an application via SNAP/TANF/foster/homeless/migrant/Medicaid) is the companion topic direct_certification.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `reporting_status` — one of: `not_participating`, `reported`, `suppressed_privacy_band`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2013–2026 (14 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE) — Free and Reduced Price Meal Eligibility","operationId":"query_topic_api_v1_education_free_reduced_lunch_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/georgia_milestones_end_of_course":{"get":{"tags":["education"],"summary":"Georgia Milestones End-of-Course (EOC) assessment results for high-school core content areas, published for each of up t","description":"Georgia Milestones End-of-Course (EOC) assessment results for high-school core content areas, published for each of up to three administrations per school year (Winter mid-year retest, Spring primary, Full-Year aggregate) at the state, district/system, and school level. Core metrics are the count of students tested, the mean scale score, and the share of students at each of the four achievement levels (Beginning, Developing, Proficient, Distinguished Learner) plus the two cumulative shares. Literature subjects add a Reading Status split against a per-course Lexile threshold (9th Grade Literature 1050L through 2020; American Literature 1185L). Student Growth Percentile (SGP) metrics appear in the source layout from Spring 2024 but carry data only from the 2024-2025 school year (Algebra: Concepts & Connections and American Literature). Full-Year 2020-2021 uniquely includes enrolled_tested_rate, reflecting COVID-era participation drops.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `administration` — one of: `winter`, `spring`, `full_year`\n- `subject` — one of: `9th_grade_literature_and_composition`, `algebra_concepts_and_connections`, `algebra_i`, `american_literature_and_composition`, `analytic_geometry`, `biology`, `coordinate_algebra`, `economics_business_free_enterprise`, `geometry`, `physical_science`, `us_history`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2015–2025 (11 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE) — Georgia Milestones End-of-Course Assessment","operationId":"query_topic_api_v1_education_georgia_milestones_end_of_course_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/georgia_milestones_end_of_grade":{"get":{"tags":["education"],"summary":"Georgia Milestones End-of-Grade (EOG) assessment results for grades 3-8 — published annually (except 2020, cancelled due","description":"Georgia Milestones End-of-Grade (EOG) assessment results for grades 3-8 — published annually (except 2020, cancelled due to COVID) at the state, district/system, and school level. The primary metrics are the count of students tested, the mean scale score, and the share of students at each of the four achievement levels (Beginning / Developing / Proficient / Distinguished Learner) plus the two cumulative shares. English Language Arts rows additionally carry Reading Status metrics (pct_below_grade_level_lexile / pct_grade_level_or_above_lexile) from 2018 onward, anchored to grade-specific Lexile thresholds (520L for grade 3, 740L for grade 4, 830L for grade 5, 925L for grade 6, 970L for grade 7, 1010L for grade 8). 2016-2021 grade 6-8 rows split affected subjects into EOG / EOC / Combined variants to represent middle-schoolers taking end-of-course exams early (captured in the assessment_type column). 2022+ drops the EOC variants (moved to the georgia_milestones_end_of_course topic), adds a Standard Deviation metric per subject, and adds Physical Science for grade 8. 2024-2025 adds Student Growth Percentile (SGP) metrics — num_sgp_received, sgp_median, pct_sgp_low_growth, pct_sgp_typical_growth, pct_sgp_high_growth — reported on the parent ELA / Mathematics rows for grades 4-8.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_level` — one of: `03`, `04`, `05`, `06`, `07`, `08`\n- `subject` — one of: `english_language_arts`, `mathematics`, `science`, `social_studies`, `physical_science`\n- `assessment_type` — one of: `eog`, `eoc`, `eog_and_eoc_combined`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2015–2025 (no data for: 2020)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE) — Georgia Milestones End-of-Grade Assessment","operationId":"query_topic_api_v1_education_georgia_milestones_end_of_grade_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/georgia_student_growth_model_end_of_course":{"get":{"tags":["education"],"summary":"Georgia Student Growth Model (GSGM / Student Growth Percentile) results on Georgia Milestones End-of-Course assessments,","description":"Georgia Student Growth Model (GSGM / Student Growth Percentile) results on Georgia Milestones End-of-Course assessments, at the state, district/system, and school level per subject. Core metrics are the median Student Growth Percentile (1-99), the count of students receiving an SGP, and growth-share metrics. 2015-2019 publish the count and share of tested students with an SGP, two achievement-level cumulative shares (Proficient / Developing Learner or above), and the share with Typical-or-High growth (SGP >= 35). The Full-Year 2022-2023 report (year 2023) redesigns the metric set: a three-band SGP split (Low < 35, Typical 35-65, High > 65) replaces the single typical-or-high share, and the tested counts, received-SGP share, and achievement shares are no longer reported. No GSGM was published for 2020-2022 (COVID). Subject coverage narrows from 8-10 subjects (2015-2016) to six (2017-2019) to two algebra courses (2023).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `subject` — one of: `9th_grade_literature_and_composition`, `algebra_i`, `american_literature_and_composition`, `analytic_geometry`, `biology`, `coordinate_algebra`, `economics_business_free_enterprise`, `geometry`, `physical_science`, `us_history`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2015–2023 (no data for: 2020, 2021, 2022)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE) — Georgia Student Growth Model on End-of-Course assessments","operationId":"query_topic_api_v1_education_georgia_student_growth_model_end_of_course_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/georgia_student_growth_model_end_of_grade":{"get":{"tags":["education"],"summary":"Georgia Student Growth Model (GSGM / SGP) on End-of-Grade (EOG) Milestones assessments","description":"Georgia Student Growth Model (GSGM / SGP) on End-of-Grade (EOG) Milestones assessments. Each row is a (year x detail_level x geography x subject x grade) cohort's growth-related measures: Median Student Growth Percentile (1-99 ordinal), share of students at or above Typical growth (SGP >= 35), and (in 2023 only) a three-bucket SGP split (Low < 35, Typical 35-65, High > 65). 2015-2019 also report achievement-level percentages (Proficient / Developing Learner and above) on the underlying EOG assessment. Data covers reporting years 2015, 2016, 2017, 2018, 2019, and 2023. No GSGM was reported during COVID years 2020-2022. 2015-2016 report four subjects (ELA, Math, Science, Social Studies); 2017-2019 report only ELA + Math; 2023 reports only ELA + Math.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_level` — one of: `all`, `04`, `05`, `06`, `07`, `08`\n- `subject` — one of: `english_language_arts`, `mathematics`, `science`, `social_studies`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2015–2023 (no data for: 2020, 2021, 2022)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE) — Georgia Student Growth Model on End-of-Grade Milestones assessments","operationId":"query_topic_api_v1_education_georgia_student_growth_model_end_of_grade_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/pathway_graduation_rate":{"get":{"tags":["education"],"summary":"Georgia's CCRPI 'Pathways' completion indicator at the state, district, and school level, 2021-2024","description":"Georgia's CCRPI 'Pathways' completion indicator at the state, district, and school level, 2021-2024. NOTE ON THE TOPIC NAME: despite `pathway_graduation_rate` (which mirrors the GaDOE/Georgia Insights file label 'Pathways Graduation Rates'), this is the CCRPI Readiness 'Pathway Completion' indicator — NOT a graduation rate. It measures, among each graduating cohort, the share who completed a coherent three-course sequence ('pathway') in each of four elective areas: Advanced Academic (AP/IB/dual enrollment), World Language, Fine Arts, and CTAE (Career, Technical, and Agricultural Education). For actual graduation rates see `graduation_rate_4_year_cohort` and `ccrpi_graduation_rate`. The four area rates are INDEPENDENT, OVERLAPPING per-area completion rates — they do NOT partition the cohort and routinely sum above 1.0 (a student completing two pathways is counted in both). No demographic breakdown. Source: Georgia Insights / GaDOE.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2021–2024 (4 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_pathway_graduation_rate_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/wida_access":{"get":{"tags":["education"],"summary":"Georgia Insights (GaDOE) WIDA ACCESS for ELLs state-level results — the spring English-language-proficiency assessment f","description":"Georgia Insights (GaDOE) WIDA ACCESS for ELLs state-level results — the spring English-language-proficiency assessment for Georgia English Learners. For each grade (kindergarten through 12) and each of eight WIDA domains — four language domains (listening, speaking, reading, writing) and four composites (oral language, literacy, comprehension, overall score) — reports the count and share of ELL students scoring at each of the six WIDA proficiency levels (Level 1 Entering through Level 6 Reaching). This is a proficiency-level DISTRIBUTION: it carries headcounts and shares per level, not the underlying 1.0-6.0 scale scores, so it cannot answer an 'average WIDA score' question. The 2021 COVID file additionally publishes enrollment-based testing-participation rates (testing was voluntary/disrupted that year). Coverage: spring 2017 through spring 2024, state level only — bronze publishes no district or school breakdown and no demographic breakouts beyond grade.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_level` — one of: `01`, `02`, `03`, `04`, `05`, `06`, `07`, `08`, `09`, `10`, `11`, `12`, `k`\n- `domain` — one of: `comprehension_composite`, `listening`, `literacy_composite`, `oral_language_composite`, `overall_score_composite`, `reading`, `speaking`, `writing`\n- `proficiency_level` — one of: `level_1_entering`, `level_2_emerging`, `level_3_developing`, `level_4_expanding`, `level_5_bridging`, `level_6_reaching`\n\n**Detail levels available:** states (default: `states`)\n\n**Year coverage:** 2017–2024 (8 years, no gaps)\n\n**NULL handling:** zero is a real value.\n\n**Source:** Georgia Insights (GaDOE)","operationId":"query_topic_api_v1_education_wida_access_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/act_scores":{"get":{"tags":["education"],"summary":"Average ACT scaled scores (1-36) and number of students tested for Georgia public schools, with official district and st","description":"Average ACT scaled scores (1-36) and number of students tested for Georgia public schools, with official district and state rollups, by ACT test component. Covers graduating-class ACT results published by GOSA from 2004 through 2024.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `test_component` — one of: `combined_english_writing`, `composite`, `english`, `mathematics`, `reading`, `science`, `writing_subscore`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (21 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_act_scores_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/advanced_placement_scores":{"get":{"tags":["education"],"summary":"Advanced Placement (AP) exam participation and qualifying-score counts for Georgia public high schools, with official di","description":"Advanced Placement (AP) exam participation and qualifying-score counts for Georgia public high schools, with official district and state rollups, published by GOSA for 2004-2024. Each row reports the number of distinct students taking AP exams, the total exams administered, the count of exams scoring 3 or higher (College Board's qualifying threshold), and a derived pass rate (tests_3_or_higher_rate). Years 2011-2024 break the counts down by AP subject in addition to a cross-subject all_subjects total; years 2004-2010 publish only the cross-subject total.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `subject` — one of: `african_american_studies`, `all_subjects`, `art_history`, `art_studio_2d_design`, `art_studio_3d_design`, `art_studio_drawing`, `biology`, `calculus_a`, `calculus_bc`, `capstone`, `capstone_research`, `chemistry`, `chinese_language_and_culture`, `computer_science_a`, `computer_science_principles`, `economics_macro`, `economics_micro`, `english_language_and_composition`, `english_literature_and_composition`, `environmental_science`, `european_history`, `french_language`, `german_language`, `government_and_politics_comparative`, `government_and_politics_us`, `human_geography`, `italian_language_and_culture`, `japanese_language_and_culture`, `latin_vergil`, `music_theory`, `physics_1`, `physics_2`, `physics_b`, `physics_c_electricity_and_magnetism`, `physics_c_mechanics`, `precalculus`, `psychology`, `spanish_language`, `spanish_literature`, `statistics`, `us_history`, `world_history`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (21 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_advanced_placement_scores_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/attendance":{"get":{"tags":["education"],"summary":"Distribution of Georgia public-school students across three absentee tiers (5 or fewer, 6-15, and more than 15 days abse","description":"Distribution of Georgia public-school students across three absentee tiers (5 or fewer, 6-15, and more than 15 days absent during the school year), plus a chronic-absence rate (10% or more of enrolled days; published from 2018) and the student count in the denominator, for every school with official district and state rollups, by demographic subgroup (race/ethnicity, gender, economic status, English proficiency, migrant status, disability status). Published by GOSA for school years 2003-04 through 2023-24.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (21 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_attendance_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/certified_personnel":{"get":{"tags":["education"],"summary":"Georgia Office of Student Achievement (GOSA) Certified Personnel dataset, compiled from local school systems' Certified/","description":"Georgia Office of Student Achievement (GOSA) Certified Personnel dataset, compiled from local school systems' Certified/Classified Personnel Information (CPI) submissions. For every Georgia public school, school district, and the state as a whole, publishes a complete grid of 27 staffing measurements per employee group (81 rows per entity-year): headcount by certificate level (Bachelor's through Doctoral, plus Other), certification status (Professional / Provisional), gender, employment status (Full/Part-time), position metrics (FTE position count, average annual/daily salary, average contract days), staff race/ethnicity, and years-of-experience bands (<1, 1-10, 11-20, 21-30, >30, plus the mean). The three employee groups are Administrators, PK-12 Teachers, and Support Personnel; coverage runs from the 2010-11 school year through 2023-24.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `employee_type` — one of: `administrators`, `pk_12_teachers`, `support_personnel`\n- `measure_category` — one of: `certificate_level`, `certified_personnel`, `gender`, `personnel`, `positions`, `race_ethnicity`, `years_experience`\n- `measure_subcategory` — one of: `11_to_20`, `1_to_10`, `21_to_30`, `4_yr_bachelors`, `5_yr_masters`, `6_yr_specialists`, `7_yr_doctoral`, `asian_pacific_islander`, `average`, `average_annual_salary`, `average_contract_days`, `average_daily_salary`, `black`, `female`, `full_time`, `greater_than_30`, `hispanic`, `less_than_1`, `male`, `multiracial`, `native_american`, `number`, `other`, `part_time`, `professional`, `provisional`, `white`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2011–2024 (14 years, no gaps)\n\n**NULL handling:** zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_certified_personnel_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/direct_certification":{"get":{"tags":["education"],"summary":"Share of K-12 students directly certified for free school meals across Georgia public schools and districts, published b","description":"Share of K-12 students directly certified for free school meals across Georgia public schools and districts, published by GOSA for fiscal years 2014-2024 (FY2024 = the 2023-24 school year). Direct certification is the automatic, categorical-eligibility subset of free/reduced-price meal eligibility — a student is directly certified because their household participates in SNAP or TANF, the student is homeless, unaccompanied youth, foster, or migrant, or (from FY2024) the household's Medicaid income is at or below the free/reduced-price-lunch standard — with no household application required. One fact table at three detail levels: school (one row per school), district (one row per district / system, including charters, state agencies, and State Schools), and state (the statewide 'State of Georgia' aggregate, published 2022-2024 only). From FY2020 the underlying numerator and denominator counts are also published. Merges the formerly separate direct_certification_school and direct_certification_district topics.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2014–2024 (11 years, no gaps)\n\n**NULL handling:** zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_direct_certification_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/dropout_rate_7_12":{"get":{"tags":["education"],"summary":"Number and rate of grade 7-12 dropouts for Georgia public schools, with official district and state rollups, by demograp","description":"Number and rate of grade 7-12 dropouts for Georgia public schools, with official district and state rollups, by demographic subgroup (race/ethnicity, gender, economic status, English proficiency, migrant status, disability status). Published by GOSA for school years 2010-11 through 2023-24.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2011–2024 (14 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_dropout_rate_7_12_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/dropout_rate_9_12":{"get":{"tags":["education"],"summary":"Number and rate of grade 9-12 dropouts for Georgia public schools, with official district and state rollups, by demograp","description":"Number and rate of grade 9-12 dropouts for Georgia public schools, with official district and state rollups, by demographic subgroup (race/ethnicity, gender, economic status, English proficiency, migrant status, disability status). Published by GOSA for school years 2010-11 through 2023-24.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2011–2024 (14 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_dropout_rate_9_12_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/educator_qualifications_emergency_and_provisional_credentials":{"get":{"tags":["education"],"summary":"Georgia Office of Student Achievement (GOSA) Emergency-credential teacher FTE report","description":"Georgia Office of Student Achievement (GOSA) Emergency-credential teacher FTE report. For every Georgia public school, school district, and the state as a whole, reports the total teacher full-time equivalent (`total_fte`), the FTE of teachers holding an Emergency teaching credential (`emergency_fte`), and the emergency-credentialed FTE as a percentage of total FTE (`emergency_fte_rate`, on a 0-1 decimal scale). Each entity has three rows — Total, High Poverty, and Low Poverty — reporting the same three metrics across poverty strata of schools. Coverage spans the 2017-2018 school year through 2023-2024. Despite the topic name referencing 'Provisional' credentials, no provisional rows appear in the source; only Emergency is reported.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `poverty_subgroup` — one of: `high_poverty`, `low_poverty`, `total`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2018–2024 (7 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_educator_qualifications_emergency_and_provisional_credentials_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/educator_qualifications_inexperienced_teachers_leaders":{"get":{"tags":["education"],"summary":"Georgia Office of Student Achievement (GOSA) Inexperienced Teachers and Leaders report","description":"Georgia Office of Student Achievement (GOSA) Inexperienced Teachers and Leaders report. For every Georgia public school, school district, and the state as a whole, reports the total educator full-time equivalent (`total_fte`), the FTE of educators classified as Inexperienced — within the first years of their career, per the ESSA inexperienced-educator standard — (`inexperienced_fte`), and the inexperienced FTE as a percentage of total FTE (`inexperienced_fte_rate`, on a 0-1 decimal scale). Unlike the sibling educator-qualifications topics (Teachers-only), this dataset reports both Teachers and Leaders (`role`), and each entity carries rows across school-poverty strata (`poverty_subgroup`: total, high_poverty, low_poverty, plus not_applicable and unknown for Leaders). Coverage spans the 2017-2018 school year through 2023-2024.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `role` — one of: `leaders`, `teachers`\n- `poverty_subgroup` — one of: `high_poverty`, `low_poverty`, `not_applicable`, `total`, `unknown`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2018–2024 (7 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_educator_qualifications_inexperienced_teachers_leaders_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/educator_qualifications_out_of_field_teachers":{"get":{"tags":["education"],"summary":"Georgia Office of Student Achievement (GOSA) Out-of-Field teacher FTE report","description":"Georgia Office of Student Achievement (GOSA) Out-of-Field teacher FTE report. For every Georgia public school, school district, and the state as a whole, reports the total teacher full-time equivalent (`total_fte`), the FTE of teachers assigned to a subject for which they are not certified (`out_of_field_fte`), and the out-of-field FTE as a percentage of total FTE (`out_of_field_fte_rate`, on a 0-1 decimal scale). Each entity has three rows — Total, High Poverty, and Low Poverty — reporting the same three metrics across poverty strata of schools. Coverage spans the 2017-2018 school year through 2023-2024.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `poverty_subgroup` — one of: `high_poverty`, `low_poverty`, `total`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2018–2024 (7 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_educator_qualifications_out_of_field_teachers_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/english_learner_exit_rate":{"get":{"tags":["education"],"summary":"Governor's Office of Student Achievement (GOSA) annual English Learner (EL) program exit activity","description":"Governor's Office of Student Achievement (GOSA) annual English Learner (EL) program exit activity. For every Georgia LEA — standard county/city districts, state and commission charter schools, State Schools, and state-agency systems — plus a single statewide aggregate row, reports the number of EL students who exited EL services, the total EL enrollment used as the denominator, and the resulting exit rate per fiscal year. Coverage is fiscal years 2019-2024 (FY2024 = the 2023-24 school year) at the district and state detail levels; no school-level detail is published. District cells below the privacy threshold are suppressed in bronze as TFS and are NULL in gold; state totals are never suppressed. This topic is the merged successor to three legacy GOSA source topics (english_learners_el_exit_rate_district_level, _state_level, and _3yr_for_report_card) that published the same metric set; the report-card edition duplicated the district/state values exactly and was dropped during the merge.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, states (default: `districts`)\n\n**Year coverage:** 2019–2024 (6 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_english_learner_exit_rate_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/enrollment_by_grade_level":{"get":{"tags":["education"],"summary":"Student enrollment counts by grade level for every Georgia public school, school district, and the state, published by G","description":"Student enrollment counts by grade level for every Georgia public school, school district, and the state, published by GOSA for school years 2010-11 through 2023-24. Each row is the total number of students enrolled in one grade (K through 12) at one entity in one enrollment-snapshot period — GaDOE counts enrollment twice per school year (Fall and Spring collection cycles), and both snapshots are preserved as distinct rows. There is no demographic breakdown: every row is a total count for its (year, geography, period, grade) cell.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `enrollment_period` — one of: `fall`, `spring`\n- `grade_level` — one of: `01`, `02`, `03`, `04`, `05`, `06`, `07`, `08`, `09`, `10`, `11`, `12`, `k`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2011–2024 (14 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_enrollment_by_grade_level_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/enrollment_demographic_shares":{"get":{"tags":["education"],"summary":"Georgia Office of Student Achievement (GOSA) enrollment demographic shares","description":"Georgia Office of Student Achievement (GOSA) enrollment demographic shares. For every Georgia public school, school district, and the state as a whole, the share of enrollment in each of 12 demographic subgroups: six race/ethnicity buckets (Asian/Pacific Islander, Black, Hispanic, Native American, Multiracial, White), two sexes (male, female — published 2011 and 2018 onward), and four special populations (migrant — published 2011 onward, economically disadvantaged, students with disabilities, English learners). This topic is COMPUTED from the shared GOSA 'Enrollment by Subgroup Programs' bronze (FTE enrollment disaggregated by subgroup); the companion enrollment_program_participation topic exposes the program-participation side of the same files. enrollment_ratio is the share GOSA publishes for each subgroup: the subgroup's FTE count over the entity's total FTE enrollment (October snapshot denominator). Coverage spans school years 2003-04 through 2023-24. The 2004-2010 files also carry the NCLB-era Met AYP and Improvement Status indicators, denormalized across the 12 demographic rows per entity-year and NULL from 2011 on (AYP retired). Demographics whose column a source year does not publish (pre-2011 migrant/male/female; 2012-2017 male/female) are emitted with NULL enrollment_ratio so the 12-demographic grid is uniform across years.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `met_ayp` — one of: `no`, `yes`\n- `improvement_status` — one of: `adeq`, `adeq_dnm`, `dist`, `ni`, `ni_ayp`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (21 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_enrollment_demographic_shares_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/enrollment_program_participation":{"get":{"tags":["education"],"summary":"Georgia Office of Student Achievement (GOSA) enrollment program participation","description":"Georgia Office of Student Achievement (GOSA) enrollment program participation. For every Georgia public school, school district, and the state as a whole, the count and share of students enrolled in each of nine state instructional programs: Remedial grades 6-8, Early Intervention Program (EIP) K-5, Remedial grades 9-12, Special Education K-12, ESOL, Special Education Pre-K, Vocational grades 9-12, Alternative Programs, and Gifted. This topic is COMPUTED from the shared GOSA 'Enrollment by Subgroup Programs' bronze (FTE enrollment disaggregated by subgroup); the companion enrollment_demographic_shares topic exposes the demographic-share side of the same files. participation_rate is the share GOSA publishes for each program: students in the program over the entity's total FTE enrollment in the grades the program serves (the denominator GOSA standardized on at the May 2013 CCRPI launch). Coverage spans school years 2010-11 through 2023-24 — the 2004-2010 bronze files predate the program-column schema expansion and publish no program data, so those years are excluded (the companion topic covers their demographic-share columns).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `program` — one of: `alt_programs`, `eip_k_5`, `esol`, `gifted`, `remedial_gr_6_8`, `remedial_gr_9_12`, `special_ed_k_12`, `special_ed_pk`, `vocation_9_12`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2011–2024 (14 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_enrollment_program_participation_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/financial_efficiency_star_rating":{"get":{"tags":["education"],"summary":"Georgia Office of Student Achievement (GOSA) Financial Efficiency Star Rating (FESR) dataset at two detail levels in one","description":"Georgia Office of Student Achievement (GOSA) Financial Efficiency Star Rating (FESR) dataset at two detail levels in one fact table: district (one row per traditional Georgia school system, FY2014-FY2024) and school (one row per school, FY2017-FY2024). Reports per-pupil expenditure (PPE) inputs — total, federal, and state/local — full-time-equivalent K-12 enrollment, a CCRPI-derived annual Single Score, and the FESR star rating (0.5-5.0 in 0.5 increments). District rows additionally carry the federal vs state/local split of total expenditures, three-year rolling PPE and Single Score averages, and a PPE percentile rank; school rows additionally carry the pre-allocation included/excluded expenditure split and the school's share of district enrollment. Coverage in tidy long form, one row per (district[, school], fiscal year). FESR and the rolling metrics are populated only on the fiscal year each publishing report treats as its newest year (FY2016-FY2019, FY2024 for districts; FY2017-FY2019, FY2024 for schools); GOSA paused the program 2020-2023. Merges the formerly separate financial_efficiency_star_rating_fesr_district and financial_efficiency_star_rating_fesr_school topics.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `is_non_compliant` (free categorical)\n\n**Detail levels available:** districts, schools (default: `schools`)\n\n**Year coverage:** 2014–2024 (11 years, no gaps)\n\n**NULL handling:** zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_financial_efficiency_star_rating_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/georgia_alternate_assessment":{"get":{"tags":["education"],"summary":"Georgia Alternate Assessment (GAA) participation and achievement-level results for Georgia public school students with s","description":"Georgia Alternate Assessment (GAA) participation and achievement-level results for Georgia public school students with significant cognitive disabilities, published by the Governor's Office of Student Achievement (GOSA). The GAA is a separate assessment from Georgia Milestones, taken by students whose IEP team determines they cannot access the general assessment. Two measure regimes share one schema: 2004-2007 is a participation summary (enrollment in AYP-applicable grades plus the count of students taking the GAA per school/district/state, no demographics, no subject), while 2011-2024 is a tidy achievement-level fact per (entity x demographic subgroup x subject) with counts and percentages at up to four achievement levels plus two derived cumulative shares. 2011-2018 is the portfolio-based 3-tier GAA 1.0 (no distinguished tier — those metrics are NULL, not 0); the Milestones-aligned 4-tier GAA 2.0 begins in 2019. Coverage: 2004-2007, 2011-2019, 2022-2024 (2008-2010 are GOSA archive gaps; 2020-2021 COVID testing suspensions).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `subject` — one of: `english_language_arts`, `mathematics`, `science`, `social_studies`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (no data for: 2008, 2009, 2010, 2020, 2021)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_georgia_alternate_assessment_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/georgia_milestones_end_of_course_by_grade_level":{"get":{"tags":["education"],"summary":"Georgia Milestones End-of-Course (EOC) assessment results disaggregated by the grade level of the test-taker, published","description":"Georgia Milestones End-of-Course (EOC) assessment results disaggregated by the grade level of the test-taker, published by the Governor's Office of Student Achievement (GOSA). Each row is one (entity x grade x demographic subgroup x course) combination reporting the number of students tested plus the count and percentage at each of four achievement levels (Beginning, Developing, Proficient, Distinguished Learner) and two derived cumulative shares. Covers school years 2014-15 through 2023-24 (2019-20 absent — EOC testing suspended due to COVID-19) at state, district, and school detail levels.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_level` — one of: `07`, `08`, `09`, `10`, `11`, `12`\n- `subject` — one of: `9th_grade_literature_and_composition`, `algebra_concepts_and_connections`, `algebra_i`, `american_literature_and_composition`, `analytic_geometry`, `biology`, `coordinate_algebra`, `economics_business_free_enterprise`, `geometry`, `physical_science`, `us_history`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2015–2024 (no data for: 2020)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_georgia_milestones_end_of_course_by_grade_level_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/georgia_milestones_end_of_course_lexile":{"get":{"tags":["education"],"summary":"Governor's Office of Student Achievement (GOSA) Georgia Milestones End-of-Course (EOC) Lexile assessment dataset","description":"Governor's Office of Student Achievement (GOSA) Georgia Milestones End-of-Course (EOC) Lexile assessment dataset. Reports Lexile reading-measure distributions derived from Georgia's two English Language Arts EOC courses (9th Grade Literature and Composition, American Literature and Composition). Each row is one (entity x subject) combination with five measures: total students tested, students with a Lexile measure, students without a Lexile score, students with Lexile at or above the grade-level midpoint (the 'on-track reader' threshold), and the average Lexile measure. Coverage is school years 2014-15 through 2023-24 (2019-20 absent — EOC testing suspended due to COVID-19) at state, district, and school detail levels. No demographic breakdown — every row is implicitly 'All Students'.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `subject` — one of: `9th_grade_literature_and_composition`, `american_literature_and_composition`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2015–2024 (no data for: 2020)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_georgia_milestones_end_of_course_lexile_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/georgia_milestones_end_of_grade_by_grade_level":{"get":{"tags":["education"],"summary":"Georgia Milestones End-of-Grade (EOG) assessment results for Georgia public-school students in grades 3-8, disaggregated","description":"Georgia Milestones End-of-Grade (EOG) assessment results for Georgia public-school students in grades 3-8, disaggregated by individual grade level. Each row is one (entity x grade x demographic subgroup x subject) cell reporting the number of students tested plus the count and percentage of test-takers at each of four achievement levels (Beginning, Developing, Proficient, Distinguished), with derived cumulative developing-or-above and proficient-or-above shares. State, district, and school detail levels. School years 2014-15 through 2023-24; 2019-20 is absent (EOG administration cancelled, COVID-19).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_level` — one of: `03`, `04`, `05`, `06`, `07`, `08`\n- `subject` — one of: `english_language_arts`, `mathematics`, `physical_science`, `science`, `social_studies`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2015–2024 (no data for: 2020)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_georgia_milestones_end_of_grade_by_grade_level_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/georgia_milestones_end_of_grade_lexile":{"get":{"tags":["education"],"summary":"Lexile reading-score outcomes for Georgia public-school students taking the Georgia Milestones End-of-Grade (EOG) Englis","description":"Lexile reading-score outcomes for Georgia public-school students taking the Georgia Milestones End-of-Grade (EOG) English Language Arts assessment in grades 3-8. Each row is one (entity x grade) cell reporting students tested, students who received a Lexile measure, students whose Lexile met or exceeded the grade-band stretch midpoint (a national reading-level benchmark), students without a Lexile score, and the average Lexile measure. State, district, and school detail levels; no demographic breakdown (every row is implicitly All Students). School years 2014-15 through 2023-24; 2019-20 is absent (EOG testing suspended, COVID-19).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `grade_level` — one of: `03`, `04`, `05`, `06`, `07`, `08`\n- `subject` — one of: `english_language_arts`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2015–2024 (no data for: 2020)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_georgia_milestones_end_of_grade_lexile_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/graduation_rate_4_year_cohort":{"get":{"tags":["education"],"summary":"Four-year high-school graduation rate for Georgia public schools, with official district and state rollups, by demograph","description":"Four-year high-school graduation rate for Georgia public schools, with official district and state rollups, by demographic subgroup (race/ethnicity, gender, disability status, English proficiency, economic status, and special populations). Reports the graduation rate, the number of graduates, and the cohort size. Published by GOSA for school years 2003-04 through 2023-24. 2011 onward is the federal four-year adjusted-cohort graduation rate (ACGR); 2004-2010 predate Georgia's ACGR adoption and use the state's earlier leaver-based methodology — the two halves are not trend-comparable (see limitations). This is the long historical 4-year series with demographic breakdowns; the sibling ccrpi_graduation_rate topic carries the GaDOE CCRPI release (2012 onward, 4- and 5-year rates with CCRPI target/flag context).\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (21 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_graduation_rate_4_year_cohort_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/high_school_completers":{"get":{"tags":["education"],"summary":"Number of Georgia public high-school completers by credential type (General Education Diplomas, Diplomas with College Pr","description":"Number of Georgia public high-school completers by credential type (General Education Diplomas, Diplomas with College Prep Endorsements, Diplomas with Vocational Endorsements, Diplomas with Both College Prep and Vocational Endorsements, Special Education Diplomas, Certificates of Attendance) and completer type (graduates vs. other completers), broken out by 9 demographic subgroups (gender, race/ethnicity, and the all-students total), with each demographic's share of the credential's completers. School, district, and state levels, school years 2010-11 through 2023-24, published by GOSA.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `completer_type` — one of: `graduates`, `other_completers`\n- `credential_type` — one of: `certificates_of_attendance`, `diplomas_college_prep`, `diplomas_college_prep_and_vocational`, `diplomas_vocational`, `general_education_diplomas`, `special_education_diplomas`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2011–2024 (14 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_high_school_completers_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/hope_eligible_graduates":{"get":{"tags":["education"],"summary":"Governor's Office of Student Achievement (GOSA) HOPE Eligibility dataset","description":"Governor's Office of Student Achievement (GOSA) HOPE Eligibility dataset. For every Georgia public high school, school district, and the state as a whole, reports the number of graduating seniors who met the academic eligibility criteria for Georgia's HOPE scholarship program. Three metrics: num_graduates (regular graduates), num_hope_eligible (subset that met HOPE academic eligibility), and hope_eligible_rate (the share that met eligibility, on a 0-1 decimal scale). Coverage: spring 2004 through spring 2024 (21 files; filename year = spring graduation year). No demographic / gender / race breakdowns — every row is the all-students total. There is a substantive series break between 2006 and 2007: state-level percent eligible drops from ~62% (2006) to ~38% (2007+). This reflects a real methodology change in HOPE eligibility determination, not a data-processing artifact: beginning with the high school graduating class of 2007, the Georgia Student Finance Commission (GSFC) began computing each student's HOPE GPA directly from electronic high-school transcript data (the GSFC-calculated HOPE GPA) rather than relying on the school-reported GPA used previously. The break is preserved as published, not 'fixed'. Treat 2004-2006 and 2007-2024 as separate eras when comparing percentages.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (21 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_hope_eligible_graduates_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/postsecondary_c11":{"get":{"tags":["education"],"summary":"Postsecondary enrollment outcomes (GOSA C11 report) for Georgia public high school graduating cohorts: the number of hig","description":"Postsecondary enrollment outcomes (GOSA C11 report) for Georgia public high school graduating cohorts: the number of high school graduates and the number of those graduates who enrolled in any postsecondary institution (in-state or out-of-state, 2-year or 4-year, tracked roughly one year after graduation), by demographic subgroup, for every Georgia public high school plus official district and state rollups. Covers HS graduating cohorts 2010-2022 (published 2012-2024). No rates are published — consumers derive the enrollment rate as num_enrolled_in_college / num_graduates.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2010–2022 (13 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_postsecondary_c11_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/postsecondary_c12":{"get":{"tags":["education"],"summary":"GOSA Postsecondary C12 Report: three raw student counts per demographic subgroup along the high-school-graduate-to-posts","description":"GOSA Postsecondary C12 Report: three raw student counts per demographic subgroup along the high-school-graduate-to-postsecondary pipeline, for every Georgia public high school with official district and state rollups — high school graduates in the cohort year (num_graduates), graduates who enrolled in a Georgia postsecondary institution (num_enrolled_in_college), and graduates who earned at least 24 postsecondary credit hours (roughly one year of college) within two years of initial enrollment (num_earned_24_credits). IMPORTANT: unlike the sibling C11 report, which counts enrollment in institutions anywhere in the nation, C12 counts Georgia institutions only (verified: for the same 2016 cohort C11 reports 71,095 enrolled statewide vs C12's 57,468, while graduate counts agree), so C11 and C12 enrollment figures are NOT directly comparable. Covers HS graduating cohorts 2008-2020; no rates are published — derive college-going rate as num_enrolled_in_college / num_graduates and credit-earning rate as num_earned_24_credits / num_graduates at query time.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2008–2020 (13 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_postsecondary_c12_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/retained_students":{"get":{"tags":["education"],"summary":"Georgia Office of Student Achievement (GOSA) Retained K-12 dataset","description":"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.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (21 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_retained_students_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/revenues_and_expenditures":{"get":{"tags":["education"],"summary":"K-12 financial reporting for every Georgia public school, school district, and the state as a whole, published by the Go","description":"K-12 financial reporting for every Georgia public school, school district, and the state as a whole, published by the Governor's Office of Student Achievement (GOSA). Each row reports the total dollar amount and the per-FTE dollar amount for one cell of a two-bucket breakdown: K-12 Revenues across 6 revenue-source categories (federal, local, state QBE, state lottery, state other, other) and K-12 Expenditures across 11 expenditure-function categories (instruction, pupil services, instructional support, school administration, general administration, maintenance and operations, transportation, media, school food services, debt services, renovation and capital projects). Covers school years 2010-11 through 2023-24.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `rev_exp_category` — one of: `k12_expenditures`, `k12_revenues`\n- `rev_exp_subcategory` — one of: `debt_services`, `federal`, `general_administration`, `instruction`, `instructional_support`, `local`, `maintenance_and_operations`, `media`, `other`, `pupil_services`, `renovation_and_capital_projects`, `school_administration`, `school_food_services`, `state_lottery`, `state_other`, `state_qbe`, `transportation`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2011–2024 (14 years, no gaps)\n\n**NULL handling:** zero is a real value.\n\n**Source:** Governor's Office of Student Achievement (GOSA)","operationId":"query_topic_api_v1_education_revenues_and_expenditures_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/salaries_and_benefits":{"get":{"tags":["education"],"summary":"Salary and benefit expenditures for Georgia public school districts (with RESA service-agency aggregates and the officia","description":"Salary and benefit expenditures for Georgia public school districts (with RESA service-agency aggregates and the official state rollup) by staff category — teachers and paraprofessionals, school administration, and general administration — plus those salary+benefit totals as a share of four district revenue and expenditure bases. Published by GOSA for school years 2010-11 through 2023-24.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `staff_category` — one of: `general_administration`, `school_administration`, `teachers_and_paraprofessionals`\n\n**Detail levels available:** districts, states (default: `districts`)\n\n**Year coverage:** 2011–2024 (14 years, no gaps)\n\n**NULL handling:** zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_salaries_and_benefits_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/sat_scores_highest":{"get":{"tags":["education"],"summary":"Average SAT scores by test section for Georgia public high schools, with official district and state rollups, using each","description":"Average SAT scores by test section for Georgia public high schools, with official district and state rollups, using each student's HIGHEST section score across SAT administrations (the companion sat_scores_recent topic reports the most-recent administration instead). Spans the 2004-2024 GOSA publications across the old SAT (Verbal/Math, later +Writing) and the 2016 redesigned SAT (Evidence-Based Reading and Writing, Math, optional Essay).\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `test_component` — one of: `combined`, `combined_test_score`, `essay_analysis_score`, `essay_reading_score`, `essay_total`, `essay_writing_score`, `evidence_based_reading_and_writing`, `math_section_score`, `mathematics`, `reading`, `reading_test_score`, `verbal_math`, `writing`, `writlang_test_score`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (21 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_sat_scores_highest_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/sat_scores_recent":{"get":{"tags":["education"],"summary":"Average SAT scores (most recent administration per student) and number of students tested for Georgia public high school","description":"Average SAT scores (most recent administration per student) and number of students tested for Georgia public high schools, with official district and state rollups, by SAT test component. 2004-2010 additionally break out demographic subgroups; 2011 onward is all-students only. Spans the 2016 SAT redesign: pre-redesign components (verbal_math, reading, mathematics, writing, combined, verbal_math_writing) and redesigned components (combined_test_score, math_section_score, evidence_based_reading_and_writing, reading_test_score, writlang_test_score, essay components) are distinct categorical values because they measure on different scales. Best-attempt scores live in the sibling topic sat_scores_highest.\n\n**Filterable categorical columns** (comma-separated values union; multiple columns AND together):\n- `test_component` — one of: `combined`, `combined_test_score`, `essay_analysis_score`, `essay_reading_score`, `essay_total`, `essay_writing_score`, `evidence_based_reading_and_writing`, `math_section_score`, `mathematics`, `reading`, `reading_test_score`, `verbal_math`, `verbal_math_writing`, `writing`, `writlang_test_score`\n\n**Detail levels available:** districts, schools, states (default: `schools`)\n\n**Year coverage:** 2004–2024 (21 years, no gaps)\n\n**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_sat_scores_recent_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/education/student_mobility_rate":{"get":{"tags":["education"],"summary":"Annual student mobility (churn) rate for Georgia public schools and districts, published by GOSA for school years 2011-1","description":"Annual student mobility (churn) rate for Georgia public schools and districts, published by GOSA for school years 2011-12 through 2023-24 (filename year = ending calendar year, e.g. 2024 = 2023-24). Mobility is the share of students enrolled at any point during the school year but not for the full year; GOSA computes it as a churn rate — student entries plus withdrawals between the fall count date and May 1, over the fall-count enrollment — so it counts moves rather than movers and can legitimately exceed 100%. One fact table at two detail levels: school (one row per school) and district (one row per district / system). No demographic breakdowns. Merges the formerly separate student_mobility_rates_school and student_mobility_rates_district topics.\n\n**Filterable categorical columns:** none\n\n**Detail levels available:** districts, schools (default: `schools`)\n\n**Year coverage:** 2012–2024 (13 years, no gaps)\n\n**NULL handling:** zero is a real value.\n\n**Source:** GOSA","operationId":"query_topic_api_v1_education_student_mobility_rate_get","parameters":[{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Exact year","title":"Year"},"description":"Exact year"},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive lower bound","title":"Year Min"},"description":"Inclusive lower bound"},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Inclusive upper bound","title":"Year Max"},"description":"Inclusive upper bound"},{"name":"district_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)","title":"District Code"},"description":"Comma-separated list of GOSA district codes (e.g. `601,602`)"},{"name":"school_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.","title":"School Code"},"description":"Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys."},{"name":"demographic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)","title":"Demographic"},"description":"Comma-separated demographic codes (e.g. `all,black,hispanic`)"},{"name":"detail","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Detail level: schools, districts, or states (depending on topic availability).","title":"Detail"},"description":"Detail level: schools, districts, or states (depending on topic availability)."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Page size","title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","csv","parquet"],"type":"string","description":"Response format: json | csv | parquet","default":"json","title":"Format"},"description":"Response format: json | csv | parquet"}],"responses":{"200":{"description":"Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"meta","description":"Discovery + health: the dataset catalog, per-topic schema, raw ODCS contracts, and the liveness probe."},{"name":"education","description":"Education-domain fact datasets. Each route is generated from a dataset's data contract; per-column categorical filters are documented on the dataset's schema/contract and at https://georgiacivicdata.org/api/datasets."},{"name":"dimensions","description":"Shared lookup tables (districts, schools, demographics) joined into fact rows on their natural keys."}]}