So you're using the API and hoping to get a BUNCH of assessment data but you're not quite getting what you expect. There's got to me more data! What's going on? Well, the issue is most likely around the dates that are being used.
There are 4 date parameters that the Assessment methods generally will accept:
date_taken_start: Looks at assessment date taken - the first date that a student would have taken the assessment.
date_taken_end: Looks at assessment date taken - the last date that a student would have taken the assessment.
start_date: Looks at enrollment data - only pulls data for students enrolled on or after this date
end_date: Looks at enrollment data - only pulls data for students whose enrollment ended on or before this date.
So let's say you are trying to get ALL of the assessment results for students who were enrolled and/or took their assessments during the first semester of a given school year. Try using the dates as follows:
date_taken_start = earliest term start date for semester 1
date_taken_end = latest term end date for semester 1
start_date = earliest term start date for semester 1
end_date = latest term end date for semester 1
What happens with those dates is that the API receives two batches of parameters.
- The test is taken between start and end of S1.
- Pull data for students who were enrolled between start and end of S1.
The start_date and end_date are optional, but if they are not provided then the API methods assume "current date". So then your results will be any currently enrolled students who took summer school assessments.
Understanding the difference between test taken dates and enrollment dates is a critical piece to better understanding the data that you are requesting and ultimately receiving from the system.