Skip to content
GET/v1/{metro}/school-calendarspartner

List school districts and their calendars

Premium. Lists the school districts we cover in a metro, each with its current and upcoming published calendar (null when we hold none for that school year). A school year runs 1 July to 30 June and is named by the year it starts in, for example 2026-27; "current" is the school year containing today in the metro.

Show more

first_day_on and last_day_on are the earliest first day and the latest last day across grades, because districts often start some grades earlier than others. Dates are the metro's local calendar dates.

A key without the school_calendars feature gets 403 feature_not_in_plan. Snow days and other emergency closures are not covered. See School calendars.

Try this requestRun it with sample data, no key needed. Paste a key to run it live.
Example request
curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/philadelphia/school-calendars"
Example response · 200
{
  "data": [
    {
      "district": {
        "slug": "example-school-district",
        "name": "Example School District",
        "state": "PA",
        "website_url": "https://www.example.org"
      },
      "current": {
        "school_year": "2026-27",
        "first_day_on": "2026-08-31",
        "last_day_on": "2027-06-10",
        "published_at": "2026-07-15T14:00:00Z",
        "board_approved_on": "2026-06-18"
      },
      "upcoming": null
    }
  ],
  "meta": {
    "metro": "philadelphia",
    "count": 1
  }
}

Try any request with sample data, no key needed. Requires the partner plan or a key entitled to it. See Plans & access.

Metro slug from /v1/metros (e.g. philadelphia).

Ctrl Enter to send