Bellwork
Start free
SchoolsSchoolid

Get school details

Get full details for a school, including extracted intelligence.

GET
/schools/{schoolId}

Get full details for a school, including extracted intelligence.

Authorization

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

schoolId*string
Formatuuid

Response Body

application/json

application/json

curl -X GET "https://loading/api/v1/schools/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "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"
      }
    ],
    "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"
          }
        ]
      }
    },
    "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
      }
    },
    "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"
      }
    ],
    "history_gated": true,
    "history_years_available": -9007199254740991,
    "caveat": "string",
    "district_id": "550e8400-e29b-41d4-a716-446655440000",
    "district_name": "string"
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
Empty

Search schools with a JSON body POST

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.

Update school fields (internal only) PATCH

Update a school's editable NCES/location/financial fields. **Internal/admin only** (requires the `internal` plan); other orgs receive 403.