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

integer

The identifier assigned to a local education agency.

NA

2.0

schoolId

integer

The identifier assigned to a school.

https://dpi.wi.gov/wise/data-elements/schoolid

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

Namespace

Code Value

Short Description

Description

uri://dpi.wi.gov/OperationalStatusDescriptor

1

Active

Active

7

Inactive

Inactive

uri://dpi.wi.gov/SchoolCategoryDescriptor

3

High School

High School

4

Junior High School

Junior High School

5

Middle School

Middle School

6

Elementary School

Elementary School

7

Combined Elementary/Secondary School

Combined Elementary/Secondary School

uri://dpi.wi.gov/GradeLevelDescriptor

1

First Grade

First Grade

2

Second Grade

Second Grade

3

Third Grade

Third Grade

4

Fourth Grade

Fourth Grade

5

Fifth Grade

Fifth Grade

6

Sixth Grade

Sixth Grade

7

Seventh Grade

Seventh Grade

8

Eighth Grade

Eighth Grade

9

Ninth Grade

Ninth Grade

10

Tenth Grade

Tenth Grade

11

Eleventh Grade

Eleventh Grade

12

Twelfth Grade

Twelfth Grade

K3

3-year-old Kindergarten

3-year-old Kindergarten (For 2023/24 SY and prior)

K4

4-year-old Kindergarten

4-year-old Kindergarten

KG

5 year old Kindergarten

5 year old Kindergarten

PK

Pre-Kindergarten

Pre-Kindergarten

uri://dpi.wi.gov/AddressTypeDescriptor

H

Home

Home

M

Mailing

Mailing

P

Physical

Physical

uri://dpi.wi.gov/EducationOrganizationIdentificationSystemDescriptor

AgencyKey

AgencyKey

DPI Enterprise AgencyKey

NCES

NCES

NCES

School

School

School

SEA

SEA

SEA

WIR

DHS WIR

Wisconsin Department of Health Services - Wisconsin Immunization Registry

IB PYP

IB School Primary Years Programme

International Baccalaureate School Primary Years Programme

IB MYP

IB School Middle Years Programme

International Baccalaureate School Middle Years Programme

IB DP

IB School Diploma Programme

International Baccalaureate Diploma Programme

IB CP

IB School Career-Related Programme

International Baccalaureate School Career-Related Programme

uri://dpi.wi.gov/IndicatorDescriptor (2023-24 and later)

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 (2023-24 and later)

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

#

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.

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 /schools | Descriptors:

GET on /schools

Wisconsin Department of Public Instruction