WI DPI WISEdata Ed-Fi Docs
/schools
Information about schools within the LEA may be obtained from the WISEdata API via a GET request on the /schools endpoint.
This endpoint is applicable for Choice schools.
Data Properties:
# Property Name Data Type Business Definition Data Element Page 1.0 localEducationAgencyId big integer The identifier assigned to a local education agency. 🚩 Format change from Integer to Big Integer (2025-26 SY and later) NA 2.0 schoolId big integer The identifier assigned to a school. 🚩 Format change from Integer to Big Integer (2025-26 SY and later) 3.0 nameOfInstitution string The full, legally accepted name of the institution. NA 4.0 operationalStatusDescriptor string The current operational status of the EducationOrganization (e.g., active, inactive). NA 5.0 shortNameOfInstitution string A short name for the institution. NA 6.0 addresses array An unordered collection of educationOrganizationAddresses. The set of elements that describes the physical location of the education entity, including the street address, city, state, ZIP code, and ZIP code + 4. NA 7.0 addressTypeDescriptor string The type of address listed for an individual or organization. For example: Physical Address, Mailing Address, Home Address, etc.) NA 8.0 city string The name of the city in which an address is located. NA 9.0 postalCode string The five or nine digit zip code or overseas postal code portion of an address. NA 10.0 stateAbbreviationDescriptor string The abbreviation for the state (within the United States) or outlying area in which an address is located. NA 11.0 streetNumberName string The street number and street name or post office box number of an address. NA 12.0 identificationCodes array An unordered collection of educationOrganizationIdentificationCodes. A unique number or alphanumeric code assigned to an education organization by a school, school system, a state, or other agency or entity. NA 13.0 educationOrganizationIdentificationSystemDescriptor string The school system, state, or agency assigning the identification code. NA 14.0 identificationCode string A unique number or alphanumeric code that is assigned to an education organization by a school, school system, state, or other agency or entity. NA 15.0 indicators array An unordered collection of educationOrganizationIndicators. An indicator or metric of an education organization. NA 16.0 indicatorDescriptor string The name or code for the indicator or metric. NA 17.0 indicatorGroupDescriptor string The name for a group of indicators. NA 18.0 indicatorValue string The value of the indicator or metric. NA 19.0 institutionTelephones array An unordered collection of educationOrganizationInstitutionTelephones. The 10-digit telephone number, including the area code, for the education entity. NA 20.0 institutionTelephoneNumberTypeDescriptor string The type of communication number listed for an individual or organization. NA 21.0 telephoneNumber string The telephone number including the area code, and extension, if applicable. NA 22.0 schoolCategories array An unordered collection of schoolCategories. The one or more categories of school. For example: High School, Middle School, and/or Elementary School. NA 23.0 schoolCategoryDescriptor string The one or more categories of school. For example: High School, Middle School, and/or Elementary School. NA 24.0 gradeLevels array An unordered collection of schoolGradeLevels. The grade levels served at the school. NA 25.0 gradeLevelDescriptor string The grade levels served at the school. NA
Descriptors:
Namespace Code Value Short Description Description uri://dpi.wi.gov/OperationalStatusDescriptor (🚫 Removed 2026-27 SY) 1 Active 7 Inactive uri://ed-fi.org/OperationalStatusDescriptor (🆕 Added 2026-27 SY) Active Active Inactive Inactive uri://dpi.wi.gov/SchoolCategoryDescriptor 3 High School 4 Junior High School 5 Middle School 6 Elementary School 7 Combined Elementary/Secondary School uri://dpi.wi.gov/GradeLevelDescriptor (:Do_Not: Removed 2026-27 SY) K4 4-year-old Kindergarten KG 5 year old Kindergarten 1 First Grade 2 Second Grade 3 Third Grade 4 Fourth Grade 5 Fifth Grade 6 Sixth Grade 7 Seventh Grade 8 Eighth Grade 9 Ninth Grade 10 Tenth Grade 11 Eleventh Grade 12 Twelfth Grade K3 3-year-old Kindergarten PK Pre-Kindergarten uri://ed-fi.org/GradeLevelDescriptor
(🆕 Added 2026-27 SY) First Grade First Grade Second Grade Second Grade Third Grade Third Grade Fourth Grade Fourth Grade Fifth Grade Fifth Grade Sixth Grade Sixth Grade Seventh Grade Seventh Grade Eighth Grade Eighth Grade Ninth Grade Ninth Grade Tenth Grade Tenth Grade Eleventh Grade Eleventh Grade Twelfth Grade Twelfth Grade Prekindergarten Prekindergarten 4-year-old Kindergarten 4-year-old Kindergarten 5-year-old Kindergarten 5-year-old Kindergarten uri://dpi.wi.gov/AddressTypeDescriptor (:Do_Not: Removed 2026-27 SY) H Home M Mailing P Physical uri://ed-fi.org/AddressTypeDescriptor (🆕 Added 2026-27 SY) Home Home Mailing Mailing Physical Physical uri://dpi.wi.gov/EducationOrganizationIdentificationSystemDescriptor AgencyKey AgencyKey DPI Enterprise AgencyKey WIR DHS WIR Wisconsin Department of Health Services - Wisconsin Immunization Registry MDC Multi-District Charter Multi-District Charter AX Assessment :Do_Not: Removed 2026-27 SY The identification code used by Assessment NCES NCES :Do_Not: Removed 2026-27 SY School School :Do_Not: Removed 2026-27 SY SEA SEA :Do_Not: Removed 2026-27 SY uri://ed-fi.org/EducationOrganizationIdentificationSystemDescriptor
(🆕 Added 2026-27 SY) 🆕 Federal Federal Federal 🆕 AX Assessment The identification code used by Assessment 🆕 DUNS DUNS DUNS 🆕 ACT ACT ACT 🆕 Other Federal Other Federal Other Federal 🆕 NCES NCES NCES 🆕 LEA LEA LEA 🆕 Other Other Other 🆕 School School School 🆕 SEA SEA SEA 🆕 USDE - OPE USDE - OPE USDE - OPE uri://dpi.wi.gov/IndicatorDescriptor CarlPerkins Carl Perkins District Carl Perkins District IB CP IB School Career-Related Programme International Baccalaureate School Career-Related Programme IB DP IB School Diploma Programme International Baccalaureate Diploma Programme IB MYP IB School Middle Years Programme International Baccalaureate School Middle Years Programme IB PYP IB School Primary Years Programme International Baccalaureate School Primary Years Programme MODH Hybrid School offers a Hybrid learning modality to indicated students. MODP In-Person School offers a In-Person learning modality to indicated students. MODV Virtual School offers a Virtual learning modality to indicated students. ReportCard Report Card Preference Report Card Preference ZE Zero Enrollment Zero Enrollment uri://dpi.wi.gov/IndicatorGroupDescriptor MOD Learning Modality Learning Modality. IB IB Program International Baccalaureate Programme uri://ed-fi.org/InstitutionTelephoneNumberTypeDescriptor Main Main Main
Use Cases:
# Use Case Title Use Case Description What to Submit/retrieve Starting the 24/25 SY, discontinue submitting K3 data through the API. K3 is not the same as K4 or PK Birth to 3 programs. Informational Only Verify not sending K3 1.0 Retrieving the 2022-23 School data (School ID, School Name, Grade Level, IB Indicator, etc.) from the WISEdata API SIS vendors should be able to do a GET on /schools and ingest the school details into their system. Starting 2022/23 SY, new code values for the EducationOrganizationIdentificationSystemDescriptor are added to help identify IB Schools. For more details, visit A validation message (L2) will be displayed in WISEdata Portal when the wrong an IB Course is submitted from a non-IB School. GET on /schools 2.0 Retrieving the 2023-24 School data (School ID, School Name, Grade Level, IB Indicator, etc.) from the WISEdata API (2023-24 and later) SIS vendors should be able to do a GET on /schools and ingest the school details into their system. Starting 2023/24 SY, the IB codes are moved to be indicatorDescriptor. For more details, visit GET on /schools