Skip to content
GET/v1/{metro}/school-calendars/{district}partner

Retrieve 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.

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/%5Bobject%20Object%5D"
Example response · 200
{
  "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
  }
}

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).

District slug from /v1/{metro}/school-calendars.

Optional parameters (1)

School year as YYYY-YY with consecutive years (2026-27; 2026-28 is a 400).

Ctrl Enter to send