API Documentation

Access structured school calendar data for districts across the United States. Get first/last day of school, breaks, holidays, and more in JSON or iCal format.

Authentication

The API supports both authenticated and unauthenticated requests:

• Free tier (no API key): 100 requests/month, rate limited by IP
• Paid tiers: Include your API key in the request header

Quick Start

// JavaScript / Node.js
const response = await fetch(
  'https://api.schools-calendar.com/calendar?district_id=tx-houston-isd',
  {
    headers: {
      'X-API-Key': 'your-api-key' // Optional for free tier
    }
  }
);
const calendar = await response.json();
console.log(calendar.firstDay); // "2025-08-11"

Endpoints

Rate Limits

Rate limit information is included in response headers:

Error Codes