Skip to contents

Downloads the current official New Jersey directory from the NJDOE Homeroom public endpoints. When Homeroom blocks non-interactive requests, the function falls back to the latest official NJDOE School Performance Reports contact roster and narrows its declared coverage to district superintendents and school principals. It returns the canonical triple list(entities, roles, meta) defined by directory-contract/v1. Districts (including single-site charter LEAs) are keyed by the county + district CDS code; schools by the county + district + school CDS code. District superintendents, business administrators, and special-education coordinators are attached as district-grain roles; school principals as school-grain roles. Source-declared vacancies are rows with person_name NA and the verbatim title_raw preserved.

Usage

fetch_directory()

Value

A named list with components:

entities

One row per organization (district / school), canonically sorted.

roles

One row per organization-role assignment (long), canonically sorted.

meta

Self-describing metadata: schema version, sources, id scheme, coverage, counts, and quality.

Details

Homeroom publishes split first/last name fields; first_name and last_name come directly from those source columns and person_name is assembled from them. The performance-report fallback publishes combined names, which remain verbatim in person_name while the split fields remain NA (see R/directory_contract.R).

This function takes no arguments, and deliberately offers no cache-age or refresh control: the directory is always-on, so there is no retained copy whose age a caller could trade against freshness.

Examples

if (FALSE) { # \dontrun{
dir <- fetch_directory()
dir$entities
dir$roles
dir$meta$counts
} # }