Schools
Search schools with a JSON body
Body-backed equivalent of GET /schools for large ID sets and metric_query contracts. Each property uses the same string representation and validation as the corresponding GET query parameter.
Body-backed equivalent of GET /schools for large ID sets and metric_query contracts. Each property uses the same string representation and validation as the corresponding GET query parameter.
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
Request Body
application/json
[key: string]?string
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://loading/api/v1/schools" \ -H "Content-Type: application/json" \ -d '{ "property1": "string", "property2": "string" }'{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"district_id": "550e8400-e29b-41d4-a716-446655440000",
"nces_id": "string",
"name": "string",
"state": "string",
"website_url": "string",
"student_count": -9007199254740991,
"grade_levels": "string",
"state_school_id": "string",
"school_type": "string",
"locale_type": "string",
"nces_data_year": "string",
"teachers_fte": 0,
"student_teacher_ratio": 0,
"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",
"latitude": 0,
"longitude": 0,
"ai_summary": "string",
"summary_generated_at": "string",
"source": "string",
"source_url": "string",
"status": "pending",
"website_mapped_at": "string",
"content_fetched_at": "string",
"content_extracted_at": "string",
"last_analysis_job_id": "550e8400-e29b-41d4-a716-446655440000",
"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"
}
],
"annual_statistics": {
"latest": {
"school_year_start": -9007199254740991,
"total_enrollment": -9007199254740991,
"enrollment_status": "string",
"teachers_fte": 0,
"teachers_status": "string",
"free_lunch_eligible": -9007199254740991,
"reduced_price_lunch_eligible": -9007199254740991,
"free_or_reduced_price_lunch_eligible": -9007199254740991,
"lunch_status": "string",
"operational_status": "string",
"school_type": "string",
"school_level": "string",
"low_grade": "string",
"high_grade": "string",
"charter_status": "string",
"magnet_status": "string",
"title_i_status": "string",
"nslp_status": "string",
"virtual_status": "string",
"student_teacher_ratio": 0,
"free_or_reduced_price_lunch_pct": 0,
"nces_directory_version": "string",
"nces_membership_version": "string",
"nces_staff_version": "string",
"nces_characteristics_version": "string",
"nces_lunch_version": "string",
"source_urls": {
"property1": "string",
"property2": "string"
},
"loaded_at": "string"
},
"trend": [
{
"school_year_start": -9007199254740991,
"total_enrollment": -9007199254740991,
"enrollment_status": "string",
"teachers_fte": 0,
"teachers_status": "string",
"free_lunch_eligible": -9007199254740991,
"reduced_price_lunch_eligible": -9007199254740991,
"free_or_reduced_price_lunch_eligible": -9007199254740991,
"lunch_status": "string",
"operational_status": "string",
"school_type": "string",
"school_level": "string",
"low_grade": "string",
"high_grade": "string",
"charter_status": "string",
"magnet_status": "string",
"title_i_status": "string",
"nslp_status": "string",
"virtual_status": "string",
"student_teacher_ratio": 0,
"free_or_reduced_price_lunch_pct": 0,
"nces_directory_version": "string",
"nces_membership_version": "string",
"nces_staff_version": "string",
"nces_characteristics_version": "string",
"nces_lunch_version": "string",
"source_urls": {
"property1": "string",
"property2": "string"
},
"loaded_at": "string"
}
],
"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"
}
]
}
},
"caveat": "string"
},
"parent_district_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"
}
],
"caveat": "string",
"district_id": "550e8400-e29b-41d4-a716-446655440000",
"district_name": "string"
}
}
],
"pagination": {
"total": -9007199254740991,
"limit": -9007199254740991,
"offset": -9007199254740991,
"has_more": true
}
}{
"error": "string",
"message": "string",
"statusCode": -9007199254740991
}{
"error": "string",
"message": "string",
"statusCode": -9007199254740991
}{
"error": "string",
"message": "string",
"statusCode": -9007199254740991
}