Districts
Search districts
Search and filter school districts. Returns NCES data plus extracted intelligence data for all results.
Search and filter school districts. Returns NCES data plus extracted intelligence data for all results.
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
Query Parameters
state?string
State abbreviation (e.g., CO, TX)
search?string
Text search on district name
status?string
Pipeline status filter: error (extraction pipeline failed)
ids?string
Comma-separated district UUIDs
list_id?string
Filter by list membership
student_count_min?integer
Minimum student enrollment
student_count_max?integer
Maximum student enrollment
school_count_min?integer
Minimum number of schools
school_count_max?integer
Maximum number of schools
revenue_per_student_min?integer
Min revenue per student ($)
revenue_per_student_max?integer
Max revenue per student ($)
expenditures_per_student_min?integer
Min expenditures per student ($)
expenditures_per_student_max?integer
Max expenditures per student ($)
student_teacher_ratio_min?number
Minimum student-teacher ratio
student_teacher_ratio_max?number
Maximum student-teacher ratio
total_staff_min?integer
Minimum total staff count
total_staff_max?integer
Maximum total staff count
tech_level?string
Technology level classification
locale_type?string
NCES locale bucket: 'city', 'suburban', 'town', or 'rural'
Value in
"city" | "suburban" | "town" | "rural"district_type?string
NCES district type classification
county?string
County name (partial match)
grade_levels?string
Comma-separated: pre_k, elementary, middle, high
vendor_ids?string
Comma-separated vendor UUIDs
vendor_category?string
sis, lms, assessment, communication, hr, finance, security, sso, devices, other
pain_point_category?string
staffing, budget, infrastructure, security, integration, compliance, enrollment, other
has_pain_points?string
true to filter districts with pain points
funding_source?string
esser, erate, title_i, bond, grant, state, other
has_funding?string
true to filter districts with funding
has_expiring_contracts?string
true to filter districts with contracts expiring in 6 months
rfp_status?string
open, closed, won, lost, no_bid
order_by?string
Sort field
Default
"name"order_ascending?string
Sort direction
Default
"true"metric_query?string
JSON annual-metric contract for generic scalar projections, filters, and sorting. Metrics are allowlisted per entity; change windows use exact school-year endpoints.
Length
length <= 16000limit?integer
Results per page
Default
50Range
value <= 200offset?integer
Pagination offset
Default
0Response Body
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/districts"{
"data": [
{
"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"
}
}
],
"pagination": {
"total": -9007199254740991,
"limit": -9007199254740991,
"offset": -9007199254740991,
"has_more": true
}
}{
"error": "string",
"message": "string",
"statusCode": -9007199254740991
}{
"error": "string",
"message": "string",
"statusCode": -9007199254740991
}Generate email for contact POST
Generate a personalized outreach email for a contact, synchronously — the draft is returned inline, not queued as a job. `template_id` is optional: pass one of the org's saved templates (see GET /org/email-templates) to mirror, or omit it to draft untemplated (the writer will still auto-pick among the org's active templates). Enterprise/internal plans only.
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.