Skip to contents

Fetch Illinois school directory

Source: R/fetch_directory.R
fetch_directory.Rd

Downloads and processes the ISBE Directory of Educational Entities, which contains contact information for all Illinois schools, districts, and other educational entities.

Usage

fetch_directory(
  end_year = NULL,
  entity_type = NULL,
  tidy = TRUE,
  use_cache = TRUE
)

Arguments

end_year

Optional school year end. Since the directory is updated nightly with current data, this parameter is ignored but included for API consistency with other fetch functions. Defaults to NULL.

entity_type

Optional filter for entity type. Valid values include:

  • "public_school" - Public schools

  • "public_district" - Public school districts

  • "charter" - Charter schools and districts

  • "special_ed" - Special education districts and schools

  • "roe" - Regional Offices of Education

  • "isc" - Intermediate Service Centers

  • "cte" - Career and Technical Education centers

  • "non_public" - Non-public schools

  • "non_public_sped" - Non-public special education

  • "detention" - Detention centers

If NULL (default), returns all entity types.

tidy

If TRUE (default), returns data with standardized column names. If FALSE, returns raw column names from the source file.

use_cache

If TRUE (default), uses locally cached data when available (cache expires after 1 day since directory is updated nightly). Set to FALSE to force re-download from ISBE.

Value

Data frame with directory information including:

rcdts_code

Full RCDTS code (Region-County-District-Type-School)

entity_type

Type of entity (district, school, charter, etc.)

entity_name

Name of the entity

administrator_name

Name of the administrator/principal

address

Street address

city

City name

state

State (always "IL")

zip

ZIP code

phone

Phone number

grades_served

Grade levels served (e.g., "PK-8", "9-12")

nces_id

NCES school/district ID

county

County name

website

Entity website URL

Examples

if (FALSE) { # \dontrun{
# Get all directory entries
dir <- fetch_directory()

# Get only public schools
public_schools <- fetch_directory(entity_type = "public_school")

# Get charter schools and districts
charters <- fetch_directory(entity_type = "charter")

# Force fresh download
dir_fresh <- fetch_directory(use_cache = FALSE)
} # }