API Overview

CoogCasa provides REST APIs for accessing sports data, scholarship information, and more.

Base URLs

Service	URL
Unified API	`https://api.coogcasa.com`
Sports Backend	`https://coog-sports-backend.coog-planner.workers.dev`
Scholarships Backend	`https://coog-scholarships-backend.coog-planner.workers.dev`

The unified API router (api.coogcasa.com) is recommended as it provides a single entry point with path-based routing.

Available APIs

Sports API

Access UH athletics data including schedules, rosters, standings, and game details.

Prefix: /sports

GET /sports/api/schedules
GET /sports/api/roster?sport=mens-basketball
GET /sports/api/standings?sport=mens-basketball
GET /sports/api/game?id=401827646

View Sports API Documentation →

Scholarships API

Search and browse UH scholarship opportunities.

Prefix: /scholarships

GET /scholarships/api/scholarships
GET /scholarships/api/scholarships?source=bauer
GET /scholarships/api/scholarship?id=123

View Scholarships API Documentation →

Health Check

Combined health check for all services:

GET /health

Response:

{
  "status": "ok",
  "service": "coog-api-router",
  "timestamp": "2026-01-24T12:00:00.000Z",
  "backends": {
    "sports": {
      "status": "ok",
      "service": "coog-sports-backend"
    },
    "scholarships": {
      "status": "ok",
      "version": "1.0.1"
    }
  }
}

Authentication

Most read endpoints are public and don’t require authentication.

Protected endpoints (triggers, admin) require an API key:

X-API-Key: your-api-key

Rate Limiting

Rate limiting is handled by Cloudflare WAF:

Default: 60 requests per minute per IP
Bulk operations: May have lower limits

When rate limited, you’ll receive a 429 Too Many Requests response.

CORS

The API supports CORS for the following origins:

https://coogcasa.com
https://www.coogcasa.com
https://coogcasa.pages.dev
http://localhost:4321-4325 (development)

Response Format

All responses are JSON with the following structure:

Success Response

{
  "data": { ... },
  "meta": {
    "timestamp": "2026-01-24T12:00:00.000Z",
    "cached": true
  }
}

Error Response

{
  "error": "Error message",
  "code": "ERROR_CODE",
  "details": { ... }
}

Common HTTP Status Codes

Code	Description
`200`	Success
`400`	Bad Request - Invalid parameters
`404`	Not Found - Resource doesn’t exist
`429`	Too Many Requests - Rate limited
`500`	Internal Server Error
`503`	Service Unavailable

Caching

Responses are cached at the edge:

Endpoint	Cache Duration
Schedules	24 hours
Rosters	24 hours
Standings	1 hour
Game details	5 minutes
Scholarships	24 hours

Use the ?nocache=1 parameter to bypass cache (if supported).

SDKs & Libraries

Currently, there are no official SDKs. Use any HTTP client:

// JavaScript/TypeScript
const response = await fetch('https://api.coogcasa.com/sports/api/schedules');
const data = await response.json();

# Python
import requests
response = requests.get('https://api.coogcasa.com/sports/api/schedules')
data = response.json()

# cURL
curl https://api.coogcasa.com/sports/api/schedules