Skip to contents

Fetch Arkansas school directory data

Source: R/fetch_directory.R
fetch_directory.Rd

Downloads and processes school and district directory data from the Arkansas Department of Education (ADE) Data Center. Combines data from the District List, School List, Superintendent Contact List, and Principal Contact List.

Usage

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

Arguments

end_year

School year end (e.g., 2025 for 2024-25). Valid: 2005-2026. If NULL (default), uses the most recent available year.

tidy

If TRUE (default), returns data in a standardized format with consistent column names. If FALSE, returns the raw combined data.

use_cache

If TRUE (default), uses locally cached data when available. Set to FALSE to force re-download from ADE.

Value

A tibble with school directory data. Tidy columns include:

  • end_year: School year end

  • state_district_id: 7-digit district LEA code

  • state_school_id: 7-digit school LEA code (NA for district rows)

  • district_name: District name

  • school_name: School name (NA for district rows)

  • entity_type: "district" or "school"

  • address: Street address

  • city: City

  • state: State (always "AR")

  • zip: ZIP code

  • phone: Phone number

  • superintendent_name: Superintendent name (district rows)

  • superintendent_email: Superintendent email (district rows)

  • principal_name: Principal name (school rows)

  • principal_email: Principal email (school rows)

Examples

if (FALSE) { # \dontrun{
# Get latest directory data
dir_data <- fetch_directory()

# Get specific year
dir_2024 <- fetch_directory(2024)

# Get raw format
dir_raw <- fetch_directory(tidy = FALSE)

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

# Filter to specific district
library(dplyr)
bentonville <- dir_data |>
  filter(grepl("BENTONVILLE", district_name))
} # }