DistrictsDistrictid
Get district details
Get full details for a district. Returns NCES data plus extracted intelligence.
Get full details for a district. Returns NCES data plus extracted intelligence.
AuthorizationBearer <token>
API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...
In: header
Path Parameters
districtId*string
Format
uuidResponse Body
application/json
application/json
curl -X GET "https://loading/api/v1/districts/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"id": "550e8400-e29b-41d4-a716-446655440000",
"nces_id": "string",
"name": "string",
"state": "string",
"website_url": "string",
"student_count": -9007199254740991,
"school_count": -9007199254740991,
"grade_span": "string",
"locale_type": "string",
"total_revenue": 0,
"revenue_per_student": 0,
"total_expenditures": 0,
"expenditures_per_student": 0,
"instructional_expenditures": 0,
"instructional_expenditures_percent": 0,
"support_services_expenditures": 0,
"student_teacher_ratio": 0,
"total_staff": 0,
"meeting_minutes_pdfs": [
null
],
"physical_address": "string",
"physical_city": "string",
"physical_state": "string",
"physical_zip": "string",
"mailing_address": "string",
"mailing_city": "string",
"mailing_state": "string",
"mailing_zip": "string",
"phone": "string",
"county": "string",
"state_district_id": "string",
"district_type": "string",
"teachers_fte": 0,
"nces_data_year": "string",
"latitude": 0,
"longitude": 0,
"strategic_priorities": [
null
],
"ai_summary": "string",
"summary_generated_at": "string",
"status": "pending",
"website_mapped_at": "string",
"content_fetched_at": "string",
"content_extracted_at": "string",
"last_analysis_job_id": "550e8400-e29b-41d4-a716-446655440000",
"data_source": "string",
"crawled_at": "string",
"error_message": "string",
"retry_count": -9007199254740991,
"notes": "string",
"last_updated_at": "string",
"created_at": "string",
"_access": {
"is_unlocked": true,
"is_unlocking": true,
"unlocked_at": "string",
"credits_spent": 0,
"unlock_cost": 0
},
"assessment_summary": {
"source_id": "string",
"state": "string",
"school_year": -9007199254740991,
"data_quality": "complete",
"subjects_available": [
"string"
],
"metrics": {
"ela": {
"proficiency_pct": 0,
"tested_count": 0,
"participation_rate": 0,
"state_proficiency_pct": 0,
"vs_state_pp": 0
},
"math": {
"proficiency_pct": 0,
"tested_count": 0,
"participation_rate": 0,
"state_proficiency_pct": 0,
"vs_state_pp": 0
},
"science": {
"proficiency_pct": 0,
"tested_count": 0,
"participation_rate": 0,
"state_proficiency_pct": 0,
"vs_state_pp": 0
}
},
"grade_summary": {
"property1": null,
"property2": null
},
"source_manifest_uri": "string",
"canonical_artifact_uri": "string",
"coverage": {
"source_id": "string",
"source_name": "string",
"publication_status": "string",
"published_at": "string",
"canonical_artifact_uri": "string",
"canonical_artifact_format": "string",
"manifest_uri": "string",
"quality_summary": {
"property1": null,
"property2": null
}
},
"comparability_warning": "string"
},
"assessment_grade_rows": [
{
"id": "string",
"source_id": "string",
"state": "string",
"school_year": -9007199254740991,
"grade": "string",
"subject": "string",
"student_group_type": "string",
"student_group": "string",
"student_group_id": "string",
"enrolled_count": 0,
"tested_count": 0,
"tested_with_scores_count": 0,
"proficiency_count": 0,
"proficiency_pct": 0,
"participation_rate": 0,
"mean_scale_score": 0,
"data_quality": "complete",
"suppression_code": "string"
}
],
"assessment_state_rows": [
{
"source_id": "string",
"state": "string",
"school_year": -9007199254740991,
"grade": "string",
"subject": "string",
"student_group_type": "string",
"student_group": "string",
"student_group_id": "string",
"enrolled_count": 0,
"tested_count": 0,
"tested_with_scores_count": 0,
"proficiency_count": 0,
"proficiency_pct": 0,
"participation_rate": 0,
"mean_scale_score": 0,
"data_quality": "complete",
"suppression_code": "string"
}
],
"special_education_finance": {
"latest": {
"fiscal_year": -9007199254740991,
"school_year_start": -9007199254740991,
"total_enrollment": -9007199254740991,
"idea_child_count": -9007199254740991,
"idea_child_count_status": "string",
"idea_part_b_revenue": 0,
"idea_part_b_revenue_flag": "string",
"total_federal_revenue": 0,
"total_revenue": 0,
"total_expenditures": 0,
"special_ed_current_expenditures": 0,
"special_ed_instructional_expenditures": 0,
"special_ed_student_support_expenditures": 0,
"special_ed_instructional_staff_support_expenditures": 0,
"special_ed_transportation_expenditures": 0,
"idea_revenue_per_sped_student": 0,
"special_ed_current_expenditures_per_sped_student": 0,
"sped_enrollment_pct": 0,
"idea_revenue_share_of_total_revenue_pct": 0,
"f33_version": "string",
"child_count_version": "string",
"source_f33_url": "http://example.com",
"source_child_count_url": "http://example.com",
"loaded_at": "string"
},
"trend": [
{
"fiscal_year": -9007199254740991,
"school_year_start": -9007199254740991,
"total_enrollment": -9007199254740991,
"idea_child_count": -9007199254740991,
"idea_child_count_status": "string",
"idea_part_b_revenue": 0,
"idea_part_b_revenue_flag": "string",
"total_federal_revenue": 0,
"total_revenue": 0,
"total_expenditures": 0,
"special_ed_current_expenditures": 0,
"special_ed_instructional_expenditures": 0,
"special_ed_student_support_expenditures": 0,
"special_ed_instructional_staff_support_expenditures": 0,
"special_ed_transportation_expenditures": 0,
"idea_revenue_per_sped_student": 0,
"special_ed_current_expenditures_per_sped_student": 0,
"sped_enrollment_pct": 0,
"idea_revenue_share_of_total_revenue_pct": 0,
"f33_version": "string",
"child_count_version": "string",
"source_f33_url": "http://example.com",
"source_child_count_url": "http://example.com",
"loaded_at": "string"
}
],
"history_gated": true,
"history_years_available": -9007199254740991,
"caveat": "string"
},
"annual_statistics": {
"latest": {
"school_year_start": -9007199254740991,
"total_enrollment": -9007199254740991,
"enrollment_status": "string",
"operational_school_count": -9007199254740991,
"total_staff_fte": 0,
"teachers_fte": 0,
"school_counselors_fte": 0,
"school_psychologists_fte": 0,
"student_support_staff_fte": 0,
"instructional_aides_fte": 0,
"district_administrators_fte": 0,
"school_administrators_fte": 0,
"total_population": -9007199254740991,
"school_age_population": -9007199254740991,
"school_age_children_in_poverty": -9007199254740991,
"finance_fiscal_year": -9007199254740991,
"total_revenue": 0,
"local_revenue": 0,
"state_revenue": 0,
"federal_revenue": 0,
"property_tax_revenue": 0,
"title_i_revenue": 0,
"state_special_education_revenue": 0,
"total_expenditures": 0,
"current_expenditures": 0,
"instruction_expenditures": 0,
"support_services_expenditures": 0,
"student_support_expenditures": 0,
"instructional_staff_support_expenditures": 0,
"general_administration_expenditures": 0,
"school_administration_expenditures": 0,
"operations_maintenance_expenditures": 0,
"student_transportation_expenditures": 0,
"capital_outlay_expenditures": 0,
"interest_on_debt_expenditures": 0,
"total_salaries": 0,
"instructional_salaries": 0,
"special_education_teacher_salaries": 0,
"employee_benefits": 0,
"long_term_debt_outstanding": 0,
"utilities_energy_expenditures": 0,
"technology_supplies_services_expenditures": 0,
"technology_equipment_expenditures": 0,
"student_teacher_ratio": 0,
"counselors_per_1000_students": 0,
"psychologists_per_1000_students": 0,
"school_age_poverty_pct": 0,
"revenue_per_student": 0,
"current_expenditures_per_student": 0,
"federal_revenue_share_pct": 0,
"nces_directory_version": "string",
"nces_membership_version": "string",
"nces_staff_version": "string",
"saipe_version": "string",
"f33_version": "string",
"source_urls": {
"property1": "string",
"property2": "string"
},
"loaded_at": "string"
},
"latest_finance": {
"school_year_start": -9007199254740991,
"total_enrollment": -9007199254740991,
"enrollment_status": "string",
"operational_school_count": -9007199254740991,
"total_staff_fte": 0,
"teachers_fte": 0,
"school_counselors_fte": 0,
"school_psychologists_fte": 0,
"student_support_staff_fte": 0,
"instructional_aides_fte": 0,
"district_administrators_fte": 0,
"school_administrators_fte": 0,
"total_population": -9007199254740991,
"school_age_population": -9007199254740991,
"school_age_children_in_poverty": -9007199254740991,
"finance_fiscal_year": -9007199254740991,
"total_revenue": 0,
"local_revenue": 0,
"state_revenue": 0,
"federal_revenue": 0,
"property_tax_revenue": 0,
"title_i_revenue": 0,
"state_special_education_revenue": 0,
"total_expenditures": 0,
"current_expenditures": 0,
"instruction_expenditures": 0,
"support_services_expenditures": 0,
"student_support_expenditures": 0,
"instructional_staff_support_expenditures": 0,
"general_administration_expenditures": 0,
"school_administration_expenditures": 0,
"operations_maintenance_expenditures": 0,
"student_transportation_expenditures": 0,
"capital_outlay_expenditures": 0,
"interest_on_debt_expenditures": 0,
"total_salaries": 0,
"instructional_salaries": 0,
"special_education_teacher_salaries": 0,
"employee_benefits": 0,
"long_term_debt_outstanding": 0,
"utilities_energy_expenditures": 0,
"technology_supplies_services_expenditures": 0,
"technology_equipment_expenditures": 0,
"student_teacher_ratio": 0,
"counselors_per_1000_students": 0,
"psychologists_per_1000_students": 0,
"school_age_poverty_pct": 0,
"revenue_per_student": 0,
"current_expenditures_per_student": 0,
"federal_revenue_share_pct": 0,
"nces_directory_version": "string",
"nces_membership_version": "string",
"nces_staff_version": "string",
"saipe_version": "string",
"f33_version": "string",
"source_urls": {
"property1": "string",
"property2": "string"
},
"loaded_at": "string"
},
"trend": [
{
"school_year_start": -9007199254740991,
"total_enrollment": -9007199254740991,
"enrollment_status": "string",
"operational_school_count": -9007199254740991,
"total_staff_fte": 0,
"teachers_fte": 0,
"school_counselors_fte": 0,
"school_psychologists_fte": 0,
"student_support_staff_fte": 0,
"instructional_aides_fte": 0,
"district_administrators_fte": 0,
"school_administrators_fte": 0,
"total_population": -9007199254740991,
"school_age_population": -9007199254740991,
"school_age_children_in_poverty": -9007199254740991,
"finance_fiscal_year": -9007199254740991,
"total_revenue": 0,
"local_revenue": 0,
"state_revenue": 0,
"federal_revenue": 0,
"property_tax_revenue": 0,
"title_i_revenue": 0,
"state_special_education_revenue": 0,
"total_expenditures": 0,
"current_expenditures": 0,
"instruction_expenditures": 0,
"support_services_expenditures": 0,
"student_support_expenditures": 0,
"instructional_staff_support_expenditures": 0,
"general_administration_expenditures": 0,
"school_administration_expenditures": 0,
"operations_maintenance_expenditures": 0,
"student_transportation_expenditures": 0,
"capital_outlay_expenditures": 0,
"interest_on_debt_expenditures": 0,
"total_salaries": 0,
"instructional_salaries": 0,
"special_education_teacher_salaries": 0,
"employee_benefits": 0,
"long_term_debt_outstanding": 0,
"utilities_energy_expenditures": 0,
"technology_supplies_services_expenditures": 0,
"technology_equipment_expenditures": 0,
"student_teacher_ratio": 0,
"counselors_per_1000_students": 0,
"psychologists_per_1000_students": 0,
"school_age_poverty_pct": 0,
"revenue_per_student": 0,
"current_expenditures_per_student": 0,
"federal_revenue_share_pct": 0,
"nces_directory_version": "string",
"nces_membership_version": "string",
"nces_staff_version": "string",
"saipe_version": "string",
"f33_version": "string",
"source_urls": {
"property1": "string",
"property2": "string"
},
"loaded_at": "string"
}
],
"history_gated": true,
"history_years_available": -9007199254740991,
"latest_breakdowns": {
"enrollment_grade": {
"school_year_start": -9007199254740991,
"source_version": "string",
"source_url": "http://example.com",
"rows": [
{
"category": "string",
"subgroup": "string",
"value": 0,
"value_status": "string"
}
]
},
"enrollment_race_sex": {
"school_year_start": -9007199254740991,
"source_version": "string",
"source_url": "http://example.com",
"rows": [
{
"category": "string",
"subgroup": "string",
"value": 0,
"value_status": "string"
}
]
},
"staff_category": {
"school_year_start": -9007199254740991,
"source_version": "string",
"source_url": "http://example.com",
"rows": [
{
"category": "string",
"subgroup": "string",
"value": 0,
"value_status": "string"
}
]
},
"idea_disability": {
"school_year_start": -9007199254740991,
"source_version": "string",
"source_url": "http://example.com",
"rows": [
{
"category": "string",
"subgroup": "string",
"value": 0,
"value_status": "string"
}
]
}
},
"breakdowns": {
"enrollment_grade": {
"trend": [
{
"school_year_start": -9007199254740991,
"source_version": "string",
"source_url": "http://example.com",
"rows": [
{
"category": "string",
"subgroup": "string",
"value": 0,
"value_status": "string"
}
]
}
],
"history_gated": true,
"history_years_available": -9007199254740991
},
"enrollment_race_sex": {
"trend": [
{
"school_year_start": -9007199254740991,
"source_version": "string",
"source_url": "http://example.com",
"rows": [
{
"category": "string",
"subgroup": "string",
"value": 0,
"value_status": "string"
}
]
}
],
"history_gated": true,
"history_years_available": -9007199254740991
},
"staff_category": {
"trend": [
{
"school_year_start": -9007199254740991,
"source_version": "string",
"source_url": "http://example.com",
"rows": [
{
"category": "string",
"subgroup": "string",
"value": 0,
"value_status": "string"
}
]
}
],
"history_gated": true,
"history_years_available": -9007199254740991
},
"idea_disability": {
"trend": [
{
"school_year_start": -9007199254740991,
"source_version": "string",
"source_url": "http://example.com",
"rows": [
{
"category": "string",
"subgroup": "string",
"value": 0,
"value_status": "string"
}
]
}
],
"history_gated": true,
"history_years_available": -9007199254740991
}
},
"caveat": "string"
}
}{
"error": "string",
"message": "string",
"statusCode": -9007199254740991
}Empty
Search districts with a JSON body POST
Body-backed equivalent of GET /districts for large ID sets and metric_query contracts. Each property uses the same string representation and validation as the corresponding GET query parameter.
Update district fields (internal only) PATCH
Update a district's editable NCES/financial fields. **Internal/admin only** (requires the `internal` plan); other orgs receive 403.