Fetch the current New Jersey education directory (directory-contract/v1)
Source:R/fetch_directory.R
fetch_directory.RdDownloads 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.
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.