CalendarConnect API

{
  "data": [ ... ],
  "pagination": {
    "total": 532,
    "page": 1,
    "limit": 20,
    "hasMore": true
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-02-27T12:00:00.000Z"
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 45 seconds."
  },
  "meta": { "requestId": "...", "timestamp": "..." }
}

curl "https://calendarconnect.app/api/v1/universities?q=mit&limit=2"

curl "https://calendarconnect.app/api/v1/universities/abc-123"

curl "https://calendarconnect.app/api/v1/universities/abc-123/events?from=2026-01-01&to=2026-06-30&category=spring_break,final_exams"

curl "https://calendarconnect.app/api/v1/events?q=finals&from=2026-05-01&to=2026-06-01&limit=5"

curl "https://calendarconnect.app/api/v1/events/upcoming"

# List universities in California
curl -H "X-API-Key: your_key" \
  "https://calendarconnect.app/api/v1/universities?state=CA&limit=10"

# Get spring break events for a university
curl -H "X-API-Key: your_key" \
  "https://calendarconnect.app/api/v1/universities/UNIVERSITY_ID/events?category=spring_break&from=2026-01-01&to=2026-06-30"

# Search for finals across all universities
curl -H "X-API-Key: your_key" \
  "https://calendarconnect.app/api/v1/events?q=final+exam&from=2026-05-01&to=2026-06-01"

# Get upcoming events for the next 30 days
curl -H "X-API-Key: your_key" \
  "https://calendarconnect.app/api/v1/events/upcoming"

const API_KEY = "your_api_key";
const BASE_URL = "https://calendarconnect.app/api/v1";

async function getUniversities(query) {
  const params = new URLSearchParams({ q: query, limit: "10" });
  const res = await fetch(`${BASE_URL}/universities?${params}`, {
    headers: { "X-API-Key": API_KEY },
  });
  const { data, pagination } = await res.json();
  return { universities: data, pagination };
}

async function getEvents(universityId, options = {}) {
  const params = new URLSearchParams();
  if (options.from) params.set("from", options.from);
  if (options.to) params.set("to", options.to);
  if (options.category) params.set("category", options.category);

  const res = await fetch(
    `${BASE_URL}/universities/${universityId}/events?${params}`,
    { headers: { "X-API-Key": API_KEY } }
  );
  const { data } = await res.json();
  return data;
}

// Usage
const { universities } = await getUniversities("Stanford");
const events = await getEvents(universities[0].id, {
  from: "2026-01-01",
  to: "2026-06-30",
  category: "spring_break,final_exams",
});
console.log(events);

import requests

API_KEY = "your_api_key"
BASE_URL = "https://calendarconnect.app/api/v1"

headers = {"X-API-Key": API_KEY}

# List universities
response = requests.get(
    f"{BASE_URL}/universities",
    headers=headers,
    params={"q": "Stanford", "limit": 5},
)
data = response.json()
universities = data["data"]
print(f"Found {data['pagination']['total']} universities")

# Get events for a university
uni_id = universities[0]["id"]
response = requests.get(
    f"{BASE_URL}/universities/{uni_id}/events",
    headers=headers,
    params={
        "from": "2026-01-01",
        "to": "2026-06-30",
        "category": "spring_break,final_exams",
    },
)
events = response.json()["data"]
for event in events:
    print(f"{event['title']} - {event['startDate'][:10]}")

# Search across all universities
response = requests.get(
    f"{BASE_URL}/events",
    headers=headers,
    params={"q": "commencement", "from": "2026-05-01"},
)
for event in response.json()["data"]:
    print(f"{event['university']['name']}: {event['title']}")