# HAYAA Athletics Public Directory API

Base URL: https://hayaaeagles.com/api/v1

The HAYAA Athletics hub is the public directory for HAYAA program websites. It exposes discovery metadata for agents and apps, plus links to the individual Basketball, Baseball/Softball, Football, and Cheer/Pom web properties.

## Discovery

- API catalog: `/.well-known/api-catalog`
- OpenAPI: `/openapi.json`
- API health: `/api/v1/health`
- OAuth authorization metadata: `/.well-known/oauth-authorization-server`
- OAuth protected resource metadata: `/.well-known/oauth-protected-resource`
- Agent authorization guide: `/auth.md`
- MCP server card: `/.well-known/mcp/server-card.json`
- Agent skills: `/.well-known/agent-skills/index.json`

## Hub Resources

- `/api/v1/health` - confirms the hub discovery API is available
- `/` - human-facing HAYAA Athletics landing page
- `/llms.txt` - concise machine-readable site summary
- `/docs/api` - this public API documentation

## Program Sites

- Basketball: https://hayaabasketball.com/
- Baseball and Softball: https://hayaabaseball.com/
- Football: https://hayaafootball.com/
- Cheer and Pom: https://sites.google.com/view/hayaacheerpom/home

For registration, schedules, teams, FAQs, documents, and contact workflows, use the sport-specific public site and API metadata.