Acuity Lab API Documentation - Government Data Repository
Base URL: https://acuitylab.net/api/government
Authentication
All requests to the Government Data API require an API key. Include the API key in the Authorization
header:
Authorization: Bearer YOUR_API_KEY
Error Responses
- 200 OK: Request was successful.
- 400 Bad Request: The request was invalid.
- 401 Unauthorized: API key is missing or invalid.
- 403 Forbidden: The API key does not have permissions for the requested resource.
- 404 Not Found: The requested resource could not be found.
- 500 Internal Server Error: Something went wrong on the server side.
8.1 GET /government/census
Retrieve combined census data for a specific year or date range, including population, age distribution, and household data.
GET https://acuitylab.net/api/government/census?year=2020®ion=California
{
"year": 2020,
"region": "California",
"population": 39500000,
"age_distribution": {
"0-18": 8500000,
"18-65": 25000000,
"65+": 6000000
},
"households": 13000000,
"median_income": 75000
}
8.2 GET /government/departments
Retrieve information on government departments, including budget allocations, staffing levels, and department performance reports.
GET https://acuitylab.net/api/government/departments?department=Education&year=2024
{
"department": "Education",
"budget_allocation": 850000000,
"staffing_levels": 20000,
"performance": {
"goals_met": 90,
"key_projects": ["School Modernization", "STEM Education Expansion"]
}
}
8.3 GET /government/demographics
Retrieve detailed demographic data, including ethnic composition, education levels, employment status, and income distribution by region.
GET https://acuitylab.net/api/government/demographics?region=NewYork&year=2024
{
"region": "New York",
"year": 2024,
"ethnic_composition": {
"White": 50,
"Black": 25,
"Asian": 15,
"Hispanic": 10
},
"education_levels": {
"high_school_graduate": 85,
"bachelor_degree": 30,
"post_graduate": 15
},
"employment_status": {
"employed": 70,
"unemployed": 5,
"not_in_labor_force": 25
},
"income_distribution": {
"low_income": 20,
"middle_income": 50,
"high_income": 30
}
}
8.4 GET /government/treasury
Retrieve treasury data, including national debt, tax revenues, budget deficit, and treasury bond rates.
GET https://acuitylab.net/api/government/treasury?year=2024
{
"year": 2024,
"national_debt": 30000000000000,
"tax_revenues": 4200000000000,
"budget_deficit": 1000000000000,
"treasury_bond_rates": {
"2_year": "1.5%",
"10_year": "2.0%",
"30_year": "2.5%"
}
}
8.5 GET /government/tax-data
Retrieve tax data, including federal and state income taxes, corporate taxes, and VAT/GST rates by region.
GET https://acuitylab.net/api/government/tax-data?year=2023®ion=California
{
"year": 2023,
"region": "California",
"federal_income_tax_rate": "22%",
"state_income_tax_rate": "9.3%",
"corporate_tax_rate": "21%",
"vat_rate": "8.25%"
}
8.6 GET /government/immigration
Retrieve immigration data, including visa types, residency permits, and citizenship applications by year and country of origin.
GET https://acuitylab.net/api/government/immigration?year=2024&visa_type=H1B
{
"year": 2024,
"visa_type": "H1B",
"total_applications": 85000,
"total_approvals": 75000,
"country_of_origin": {
"India": 40000,
"China": 15000,
"Mexico": 5000,
"Others": 15000
}
}
8.7 GET /government/education-statistics
Retrieve data on education systems, including enrollment rates, graduation rates, public and private school statistics, and education funding.
GET https://acuitylab.net/api/government/education-statistics?region=Texas&year=2023
{
"region": "Texas",
"year": 2023,
"enrollment_rates": {
"primary_school": 95,
"high_school": 85,
"college": 60
},
"graduation_rates": {
"high_school": 90,
"college": 55
},
"funding": {
"public_schools": 300000000,
"private_schools": 100000000
}
}
8.8 GET /government/healthcare-data
Retrieve healthcare data, including public health statistics, hospital bed counts, healthcare spending, and vaccination rates.
GET https://acuitylab.net/api/government/healthcare-data?region=Florida&year=2024
{
"region": "Florida",
"year": 2024,
"hospital_beds": 50000,
"healthcare_spending": 15000000000,
"vaccination_rates": {
"measles": "85%",
"covid-19": "75%"
}
}