/v1/{metro}/school-calendars/{district}/dayspartnerAnswer each date in a window
Premium. One answer for every date from from to to inclusive, weekends included, in date order. from and to are required and the window is at most 366 days.
Show more
Each day has a type (school, no_school, half_day, break or summer) and a reason. Every stated date carries a source: the page we read it from, the exact wording quoted from it, and when we last checked it. Days that follow from the calendar rather than being named in it (weekends, ordinary school days between stated dates, summer) have source: null; unavailable days do too. basis says whether the answer is stated outright by the district, implied (for example a school day between stated dates), or unknown.
Unavailable is not summer. When we cannot answer a date, type, is_school_day and source are null, basis is unknown and reason starts with unavailable_. Treat that as "we do not know", never as a closure. summer is only returned between a calendar's last day and the next first day or, when the next school year is not published yet, up to 31 July. After that the date is unavailable. A district with no published calendar for the window returns 200 with every date unavailable and edition: null.
Grades. Without grade, a date is school only if it is a school day for every grade. Where grades get different answers the day also carries by_grade, grouping grades that share an answer. With grade, the top-level answer is that grade's, and by_grade is omitted. Asking for a grade the district does not serve is a 400.
Dates are the metro's local calendar dates. Snow days and other emergency closures are not covered. See School calendars.
curl -sS \
-H "X-API-Key: $TAILEND_API_KEY" \
"https://api.tailend.dev/v1/philadelphia/school-calendars/example-school-district/days?from=2026-10-01&to=2026-10-31"{
"data": [
{
"date": "2026-11-26",
"type": "no_school",
"reason": "holiday",
"label": "Thanksgiving recess",
"is_school_day": false,
"basis": "stated",
"source": {
"url": "https://www.example.org/calendar",
"quote": "Thanksgiving recess, November 26-27",
"verified_at": "2026-10-01T12:00:00Z"
}
},
{
"date": "2026-11-27",
"type": "no_school",
"reason": "holiday",
"label": "Thanksgiving recess",
"is_school_day": false,
"basis": "stated",
"source": {
"url": "https://www.example.org/calendar",
"quote": "Thanksgiving recess, November 26-27",
"verified_at": "2026-10-01T12:00:00Z"
}
},
{
"date": "2026-11-28",
"type": "no_school",
"reason": "weekend",
"label": null,
"is_school_day": false,
"basis": "implied",
"source": null
}
],
"edition": {
"school_year": "2026-27",
"published_at": "2026-07-15T14:00:00Z",
"board_approved_on": "2026-06-18"
},
"meta": {
"metro": "philadelphia",
"district": "example-school-district",
"from": "2026-11-26",
"to": "2026-11-28",
"count": 3,
"unavailable_count": 0
}
}