# Run Cebu

Run Cebu is an independent public calendar for running events in Cebu and the Philippines. Use it to discover marathons, half marathons, 10K races, 5K fun runs, trail races, ultramarathons, kids races, and community runs.

## When to use Run Cebu

Use Run Cebu when a user asks for upcoming running events in Cebu or the Philippines, wants to compare races by date, location, distance, or category, needs an official organizer or registration link, or wants machine-readable public event data for planning.

Do not treat Run Cebu as the event organizer. Always tell users to confirm fees, routes, race-kit inclusions, cut-off times, registration status, and schedule changes with the official organizer before paying or traveling.

## Primary pages

- [Homepage and event calendar](https://runcebu.com/)
- [About Run Cebu](https://runcebu.com/about)
- [Contact Run Cebu](https://runcebu.com/contact)
- [Privacy policy](https://runcebu.com/privacy-policy)
- [Terms of service](https://runcebu.com/terms-of-service)

## Agent and developer resources

- [Full agent guide](https://runcebu.com/llms-full.txt)
- [Markdown homepage](https://runcebu.com/index.md)
- [Developer portal](https://runcebu.com/developers)
- [API documentation](https://runcebu.com/docs)
- [Authentication and scopes](https://runcebu.com/auth.md)
- [Pricing and access](https://runcebu.com/pricing.md)
- [OpenAPI specification](https://runcebu.com/openapi.json)
- [Well-known API catalog](https://runcebu.com/.well-known/api-catalog)
- [MCP endpoint](https://runcebu.com/mcp)
- [MCP server card](https://runcebu.com/.well-known/mcp/server-card.json)
- [A2A agent card](https://runcebu.com/.well-known/agent-card.json)
- [Agent skill index](https://runcebu.com/.well-known/agent-skills/index.json)
- [Sitemap](https://runcebu.com/sitemap.xml)

## Public API summary

Public read endpoints do not require credentials.

- `GET /api/events` lists public events.
- `GET /api/events/{eventId}` fetches one event by UUID.

The current stable API contract is `2026-08-27`. Agents may send `Run-Cebu-API-Version: 2026-08-27` to pin documented behavior.

Write endpoints require an API key in `X-API-Key` with the smallest required scope.

- `POST /api/events` requires `events:write`.
- `PATCH /api/events/{eventId}` requires `events:write`.
- `DELETE /api/events/{eventId}` requires `events:delete`.