{"openapi":"3.1.0","info":{"title":"Naturalizations (Georgia Civic Data)","version":"1.0.0","description":"Georgia residents who became U.S. citizens by naturalization each federal fiscal year, with FY2024 country and region of birth.","license":{"name":"Creative Commons Attribution 4.0 International (CC BY 4.0)","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://georgiacivicdata.org"}],"paths":{"/api/v1/datasets/naturalizations/rows":{"get":{"operationId":"naturalizations_rows","summary":"Rows of Naturalizations","parameters":[{"name":"year","in":"query","required":false,"description":"year exact","schema":{"type":"string","pattern":"^\\d{4}(,\\d{4})*$"}},{"name":"year_min","in":"query","required":false,"description":"year range","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"year range","schema":{"type":"integer"}},{"name":"detail","in":"query","required":false,"description":"detail","schema":{"type":"string","enum":["states"],"default":"states"}},{"name":"county_fips","in":"query","required":false,"description":"foreign key","schema":{"type":"string"}},{"name":"country_of_birth","in":"query","required":false,"description":"categorical; comma-separated, any of: all, afghanistan, bangladesh, brazil, burma, china, colombia, cuba, dominican_republic, el_salvador, ethiopia, ghana, guatemala, haiti, honduras, india, iran, jamaica, kenya, mexico, nigeria, pakistan, philippines, south_korea, united_kingdom, venezuela, vietnam, other, unknown","schema":{"type":"string"}},{"name":"region_of_birth","in":"query","required":false,"description":"categorical; comma-separated, any of: all, africa, asia, europe, north_america, oceania, south_america, unknown","schema":{"type":"string"}},{"name":"num_naturalizations_min","in":"query","required":false,"description":"metric bound","schema":{"type":"number"}},{"name":"num_naturalizations_max","in":"query","required":false,"description":"metric bound","schema":{"type":"number"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0}},{"name":"sort","in":"query","description":"comma list; prefix - for descending","schema":{"type":"string"}},{"name":"columns","in":"query","schema":{"type":"string"}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv","parquet"]}}],"responses":{"200":{"description":"rows"}}}},"/api/v1/datasets/naturalizations/aggregate":{"get":{"operationId":"naturalizations_aggregate","summary":"Grouped figures computed on the server","parameters":[{"name":"year","in":"query","required":false,"description":"year exact","schema":{"type":"string","pattern":"^\\d{4}(,\\d{4})*$"}},{"name":"year_min","in":"query","required":false,"description":"year range","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"year range","schema":{"type":"integer"}},{"name":"detail","in":"query","required":false,"description":"detail","schema":{"type":"string","enum":["states"],"default":"states"}},{"name":"county_fips","in":"query","required":false,"description":"foreign key","schema":{"type":"string"}},{"name":"country_of_birth","in":"query","required":false,"description":"categorical; comma-separated, any of: all, afghanistan, bangladesh, brazil, burma, china, colombia, cuba, dominican_republic, el_salvador, ethiopia, ghana, guatemala, haiti, honduras, india, iran, jamaica, kenya, mexico, nigeria, pakistan, philippines, south_korea, united_kingdom, venezuela, vietnam, other, unknown","schema":{"type":"string"}},{"name":"region_of_birth","in":"query","required":false,"description":"categorical; comma-separated, any of: all, africa, asia, europe, north_america, oceania, south_america, unknown","schema":{"type":"string"}},{"name":"num_naturalizations_min","in":"query","required":false,"description":"metric bound","schema":{"type":"number"}},{"name":"num_naturalizations_max","in":"query","required":false,"description":"metric bound","schema":{"type":"number"}},{"name":"agg","in":"query","schema":{"type":"string","enum":["avg","sum","min","max","count","weighted_rate"]}},{"name":"metric","in":"query","schema":{"type":"string","enum":["num_naturalizations"]}},{"name":"group_by","in":"query","description":"comma list of: year, county_fips, country_of_birth, region_of_birth","schema":{"type":"string"}}],"responses":{"200":{"description":"groups"}}}}}}