# Event Schedule

> Event Schedule is an open-source platform for sharing events, selling tickets, and bringing communities together. It provides a full REST API with OpenAPI 3.0 spec for programmatic event management.

Event Schedule supports three schedule types: **venue** (physical locations like bars, theaters, galleries), **talent** (performers like musicians, DJs, comedians), and **curator** (event organizers and promoters). Authentication uses API key via `X-API-Key` header, obtained through registration or login. Read operations are free; write operations require a Pro plan. Rate limits: 300 GET requests per minute, 30 POST/PUT/DELETE requests per minute. Events auto-translate to 10 languages. The platform is available as hosted SaaS at eventschedule.com or selfhosted.

## API Documentation

- [API Reference](https://eventschedule.com/docs/developer/api): Full API documentation with examples for all endpoints
- [OpenAPI Spec](https://eventschedule.com/api/openapi.json): OpenAPI 3.0 specification for client generation and tool integration
- [agents.json](https://eventschedule.com/.well-known/agents.json): Agent workflow definitions for multi-step API tasks

## Getting Started

1. Register an account: `POST /api/register` (hosted mode requires email verification via `POST /api/register/send-code` first)
2. Create a schedule: `POST /api/schedules` with a name and type (venue, talent, or curator)
3. Create events: `POST /api/events/{subdomain}` with event details under your schedule
4. Optionally configure tickets, upload flyers, and create sub-schedules

## Platform Information

- [Features](https://eventschedule.com/features): Full feature overview including ticketing, calendar sync, analytics, and more
- [Pricing](https://eventschedule.com/pricing): Free for read operations, Pro plan for write operations, zero platform fees on tickets
- [For AI Agents](https://eventschedule.com/for-ai-agents): Overview of API capabilities for AI agents and developers
- [Documentation](https://eventschedule.com/docs): User guides for schedules, events, tickets, and integrations

## Optional

- [Selfhost Guide](https://eventschedule.com/docs/selfhost/installation): Instructions for self-hosting Event Schedule
- [Open Source](https://eventschedule.com/open-source): Source code and contribution information
- [Blog](https://eventschedule.com/blog): Platform updates and use case guides