/studentHomelessProgramAssociation

Ed-Fi Tech Docs: https://techdocs.ed-fi.org/display/EDFICERT/v3+Student+Program+%3E+StudentHomelessProgramAssociation

Data Properties:

Click here to view all data properties under the /student endpoint:

#	Property Name	Data Type	Public (Required/ Optional/ Conditional)	Choice (Required/ Optional/ Conditional)	Business Definition	Data Element Page
1.0	beginDate	string	CONDITINALLY REQ'D	NOT REQ'D	The earliest date the student is involved with the program. Typically, this is the date the student becomes eligible for the program.	https://dpi.wi.gov/wise/data-elements/homeless-begin-end-dates
2.0	educationOrganizationId	integer	CONDITINALLY REQ'D	NOT REQ'D	The identifier assigned to an education organization.	https://dpi.wi.gov/wise/data-element/edorgid
3.0	programName	string	CONDITINALLY REQ'D	NOT REQ'D	The formal name of the Program of instruction, training, services, or benefits available through federal, state, or local agencies. The value is: Education for Homeless Children and Youth	https://dpi.wi.gov/wise/data-elements/homeless-status
4.0	programTypeDescriptor	string	CONDITINALLY REQ'D	NOT REQ'D	The type of program, which is ‘uri://dpi.wi.gov/ProgramTypeDescriptor#H’	NA
5.0	studentUniqueId	string	CONDITINALLY REQ'D	NOT REQ'D	A unique alphanumeric code assigned to a student.	https://dpi.wi.gov/wise/data-elements/WISEid
6.0	endDate	string	CONDITINALLY REQ'D	NOT REQ'D	The month, day, and year on which the Student exited the Program or stopped receiving services.	https://dpi.wi.gov/wise/data-elements/homeless-begin-end-dates
7.0	homelessPrimaryNighttimeResidenceDescriptor	string	CONDITINALLY REQ'D	NOT REQ'D	The primary nighttime residence of the student at the time the student is identified as homeless. Values are: Shelters and Transitional Housing (S), Doubled Up (D), Hotel/Motels (H), and Unsheltered (U)	https://dpi.wi.gov/wise/data-elements/homeless-primary-nighttime-residence
8.0	homelessUnaccompaniedYouth	boolean	CONDITINALLY REQ'D	NOT REQ'D	A homeless unaccompanied youth is a youth who is not in the physical custody of a parent or guardian and who fits the McKinney-Vento definition of homeless. Students must be both unaccompanied and homeless to be included as an unaccompanied homeless youth.	https://dpi.wi.gov/wise/data-elements/homeless-unaccompanied-youth

Use Cases:

Click here to view all the use cases pertaining to the /student endpoint:

#	Use Case Title	Use Case Description	What to Submit/retrieve
1.0	Sending a student who is enrolled in the same school throughout the school year, and is identified as homeless	The district in which the student is enrolled will submit the student Homeless Program Association (SHPA) The SHPA Begin Date is a required field and should be either on the day the student's enrollment (SSA) began OR on the date when a student is identified as homeless. Because the student is homeless for the entirety of the school year, the End Date is not needed.	POST on /studentHomelessProgramAssociation : beginDate: 2022-08-01 endDate: homelessprimaryNighttimeResidenceDescriptor: uri://dpi.wi.gov/homelessprimaryNighttimeResidenceDescriptor#S homelessUnaccompaniedYouth: true
2.0	Sending a student who is enrolled in the same school throughout the school year, and is identified as temporarily homeless	Because the student is homeless for a specified period of time, the SHPA End Date must be updated for when the student finds permanent residence, which can be any time during the enrollment period. The Homeless End Date is the date when a student secures permanent residence and is no longer identified as homeless. If SHPA End Date is not known, then enter the student's exit date, leave it blank, or provide DPI the school year end date	POST on /studentHomelessProgramAssociation : beginDate: 2022-08-01 endDate: 2022-10-14 homelessprimaryNighttimeResidenceDescriptor: uri://dpi.wi.gov/homelessprimaryNighttimeResidenceDescriptor#S homelessUnaccompaniedYouth: true
3.0	Sending a student who is identified as homeless at School A, and transfers to School B and continues to be homeless	School A will submit the Begin Date as the date the student was first identified as homeless. School A leaves the End Date null because the student hasn't yet found permanent residence. When the student transfers to School B, School B then submits an SHPA record with Begin Date as the date the student enrolled, as the student has continued to be homeless. The End Date is null for School B as well because the student has still not secured permanent residence. Two SHPA records cannot overlap within the same school during a given school year.	School A: POST on /studentHomelessProgramAssociation: beginDate: 2022-08-01 endDate: homelessprimaryNighttimeResidenceDescriptor: uri://dpi.wi.gov/homelessprimaryNighttimeResidenceDescriptor#H homelessUnaccompaniedYouth: fales School B: POST on /studentHomelessProgramAssociation: beginDate: 2022-10-01 endDate: homelessprimaryNighttimeResidenceDescriptor: uri://dpi.wi.gov/homelessprimaryNighttimeResidenceDescriptor#S homelessUnaccompaniedYouth: fales
4.0	Sending a student who is identified as homeless at School A, and transfers to School B but is no longer homeless	School A will submit the Begin Date as the date the student was first identified as homeless within the enrollment period. School A submits the Homeless End Date as the date the student finds permanent residence and must be within the enrollment period. School B does not need to submit an SHPA record for the student because the student has not been identified as homeless during the enrollment period with School B.	School A: POST on /studentHomelessProgramAssociation : beginDate: 2022-08-23 endDate: 2022-11-14 homelessprimaryNighttimeResidenceDescriptor: uri://dpi.wi.gov/homelessprimaryNighttimeResidenceDescriptor#D homelessUnaccompaniedYouth: true School B: Doesn’t submit /studentHomelessProgramAssociation
5.0	Sending a student who is identified as homeless, and his/her Primary Nighttime Residence changes	A student’s primary nighttime residence is determined at the time of the initial identification of homelessness. LEAs can update the residence type for a homeless student at any time without needing to create a brand new SHPA record. The program data, including Begin Date, can remain in place when updating the residence value.	PUT on /studentHomelessProgramAssociation : beginDate: 2022-08-23 endDate: 2022-11-14 homelessprimaryNighttimeResidenceDescriptor: uri://dpi.wi.gov/homelessprimaryNighttimeResidenceDescriptor#U homelessUnaccompaniedYouth: true
6.0	Sending a student who is identified as homeless, and his/her Unaccompanied Youth Status changes	A student’s unaccompanied youth status is determined at the time of the initial identification of homelessness. LEAs can update the unaccompanied youth status for a homeless student at any time without needing to create a brand new SHPA record. The program data, including Begin Date, can remain in place when updating the unaccompanied youth value.	PUT on /studentHomelessProgramAssociation : beginDate: 2022-08-23 endDate: 2022-11-14 homelessprimaryNighttimeResidenceDescriptor: uri://dpi.wi.gov/homelessprimaryNighttimeResidenceDescriptor#U homelessUnaccompaniedYouth: false

JSON Sample:

JSON sample for public LEAs:

{
	"educationOrganizationReference": {
		"educationOrganizationId": 7525
	},
	"programReference": {
		"educationOrganizationId": 48856,
		"programtypeDescriptor": "uri://dpi.wi.gov/ProgramTypeDescriptor#H",
		"programname": "Education for Homeless Children and Youth"
	},
	"studentReference": {
		"studentUniqueId": "8660232105"
	},
	"beginDate": "2020-07-01",
	"endDate": "2021-06-05",
	"homelessprimaryNighttimeResidenceDescriptor": "uri://dpi.wi.gov/homelessprimaryNighttimeResidenceDescriptor#S",
	"homelessUnaccompaniedYouth": true
}