Endpoints

One summary per dataset (title, source, year range, detail levels, endpoint) plus a dimensions block. No parameters.

curl "https://georgiacivicdata.org/api/v1/datasets"

The full schema: every column (name, type, role, unit, range, allowed values, description), the structured filters list, foreign keys, the key_metric pointer, available years, and the schema_hash. This is what powers these docs.

curl "https://georgiacivicdata.org/api/v1/datasets/education/act_scores"

The authoritative ODCS v3.2 contract. ?format=yaml (default) returns it verbatim; ?format=json returns it parsed.

curl "https://georgiacivicdata.org/api/v1/datasets/education/act_scores/contract?format=yaml"

Query a dataset’s rows. Common parameters:

curl "https://georgiacivicdata.org/api/v1/education/act_scores?year=2024&test_component=composite&detail=districts"

Read an education-scoped lookup table — districts, schools, or demographics — paginated with limit / offset. These supply the label columns the fact queries join in.

curl "https://georgiacivicdata.org/api/v1/education/_dimensions/districts?limit=10"

Read a global lookup table — counties (all 159 Georgia counties, FIPS code + name) or demographics. The education route above remains for districts, schools, and demographics.

curl "https://georgiacivicdata.org/api/v1/_dimensions/counties?limit=10"

A dimension’s primary key, attributes, and link keys.

Zone polygons, one per school, level, and grade span. Parameters:

Each zone’s properties include school and district labels, nces_school_id, nces_lea_id, and its provenance: method, accuracy_class, positional_rmse_m, boundary_vintage, currency_status, currency_note (what changed and when, for a zone whose source predates an adopted change), source_url, source_publisher, and retrieved_on. Every format carries the note that a zone is not an official enrollment determination: a top-level note in GeoJSON and json, a README.txt in the shapefile zip, and the GeoParquet file metadata.

curl "https://georgiacivicdata.org/api/v1/education/school_attendance_zones?district_code=761&zone_level=high"

Every field with its type and description, the meaning of each enum value, the coordinate reference system (OGC:CRS84: longitude, latitude), the map from each field to its 10-character shapefile field name, and the companion files, with the columns of the coverage table. A shapefile text field holds at most 254 bytes, so a longer value (a long boundary_vintage or source_url) is cut there and ends with ...; the other formats carry the full text, and currency_note always fits.

One row per Georgia school district: its status (complete, partial, one_school_per_grade, or not_available), the status of each level (zoned, one_school_per_grade, partial, not_available, or served_by_other_district), the share of its land and 2020 population the zones cover, and why anything is missing. format=json (default) or geojson (with district outlines).

Give lat and lon, or tract_geoid, plus an optional grade and year.

Every response carries a note that it is not an official enrollment determination, and is sent with Cache-Control: no-store. A GET puts the coordinates in the URL, which passes through our hosting platform; our application never writes them to its logs. To keep a point out of URLs, send it by POST.

curl "https://georgiacivicdata.org/api/v1/education/school_attendance_zones/lookup?lat=33.7479&lon=-84.3903&grade=09"

A JSON body with exactly one of the following, plus an optional grade and year:

Addresses are accepted only by POST, so they never appear in a URL. Our application never writes addresses or coordinates to its application logs, and never caches or records them. POST is also the private way to send a point. Responses are sent with Cache-Control: no-store. Rate limits per client: 120 requests a minute for GET lookups and 20 a minute for POST.

curl -X POST "https://georgiacivicdata.org/api/v1/education/school_attendance_zones/lookup" \
  -H "Content-Type: application/json" \
  -d '{"address": "55 Trinity Ave SW, Atlanta, GA 30303"}'

Census TIGER/Line school district boundaries for Georgia, keyed to district_code. Filter with district_code; the same format options as the zones.