/v1/{metro}/school-calendars/{district}partnerRetrieve a district's stated calendar
Premium. The calendar as the district states it for one school year: a list of dated entries, so a client can draw the year without requesting every day. Each entry is a date or date range with a type, a reason, the district's own label, the grades it applies to and where it was stated. Entries are in date order.
Show more
school_year defaults to the school year containing today in the metro. When we hold no published calendar for that year, edition is null and entries is empty; that is not a statement that school is out. Use undefined for a per-date answer, including dates we cannot answer.
grades: null means the entry applies to all students.
District policies are not served yet: policies is always an empty array and meta.policy_count is 0. The field is reserved.
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/%5Bobject%20Object%5D"{
"data": {
"district": {
"slug": "example-school-district",
"name": "Example School District",
"state": "PA",
"website_url": "https://www.example.org"
},
"school_year": "2026-27",
"edition": {
"school_year": "2026-27",
"published_at": "2026-07-15T14:00:00Z",
"board_approved_on": "2026-06-18"
},
"entries": [
{
"starts_on": "2026-08-31",
"ends_on": "2026-08-31",
"type": "school",
"reason": "first_day",
"label": "First day for students",
"grades": null,
"source": {
"url": "https://www.example.org/calendar",
"quote": "First day for students, Monday, August 31",
"verified_at": "2026-10-01T12:00:00Z"
}
},
{
"starts_on": "2026-11-26",
"ends_on": "2026-11-27",
"type": "no_school",
"reason": "holiday",
"label": "Thanksgiving recess",
"grades": null,
"source": {
"url": "https://www.example.org/calendar",
"quote": "Thanksgiving recess, November 26-27",
"verified_at": "2026-10-01T12:00:00Z"
}
}
],
"policies": []
},
"meta": {
"metro": "philadelphia",
"district": "example-school-district",
"school_year": "2026-27",
"entry_count": 2,
"policy_count": 0
}
}