# Vihaya Events

> Ticketing and registration infrastructure for events. The API is the backend for
> booking, payment, ticketing and check-in — you build the front end and call it.

- API base URL: https://events.vihaya.app
- Auth: `x-api-key: <your key>` header on every request
- Get a key: https://events.vihaya.app/profile/developer/keys

## Start here

- [Full API context for coding agents](https://docs.vihaya.app/llms-full.txt): every endpoint, field, error code and the traps that are not in the schema. Fetch this one if you are writing code.
- [OpenAPI 3.1 specification](https://events.vihaya.app/api/v1/openapi.json): generated from the route definitions, so it cannot fall behind the running API.
- [Build with AI](https://docs.vihaya.app/docs/build-with-ai): a copy-paste brief for handing this API to a coding agent.

## Get Started

- [Introduction](https://docs.vihaya.app/docs): What Vihaya Events is and which part of it you are meant to build on.
- [Installation](https://docs.vihaya.app/docs/installation): Getting an account, an organiser role and an API key.
- [Quick Start](https://docs.vihaya.app/docs/quick-start): Create an event and take a first booking, end to end.
- [Build with AI](https://docs.vihaya.app/docs/build-with-ai): Hand this API to a coding agent: a copy-paste brief, the machine-readable context bundle, and a working booking-site starter.

## Event Management

- [Event Overview](https://docs.vihaya.app/docs/event-overview): What an attendee sees on an event page, including sub-events and sessions.
- [Organizer Profile](https://docs.vihaya.app/docs/event-management/organizer-profile): The organiser account, the events list, and who else may manage an event.
- [Creating Events](https://docs.vihaya.app/docs/event-management/creating-events): Every field on the create-event form, section by section.
- [Edit Event Settings](https://docs.vihaya.app/docs/event-management/event-settings): Changing an event after it is published, and what cannot be changed.
- [Payment & Pricing](https://docs.vihaya.app/docs/event-management/payment-pricing): Ticket price, tiers, early bird, promo codes and the platform fee.
- [Registration Form Fields](https://docs.vihaya.app/docs/event-management/form-builder): Custom questions on the registration form and the answers they produce.
- [Child Events](https://docs.vihaya.app/docs/event-management/child-events): Mega events: a parent with separately bookable tracks or sessions.
- [Registration Management](https://docs.vihaya.app/docs/event-management/guests-management): The attendee directory, filtering, and exporting registration data.
- [QR Scanning & Check-In](https://docs.vihaya.app/docs/event-management/qr-scanning): Ticket QR codes, the check-in desk, and scanning for food or sessions.
- [In-Event Features](https://docs.vihaya.app/docs/event-management/in-event): Broadcasts, live ticker, reminders and feedback while the event runs.
- [Event Analytics](https://docs.vihaya.app/docs/event-management/event-analytics): Tickets, revenue, turnout, and the per-track and per-college breakdowns.
- [Post Event Management](https://docs.vihaya.app/docs/event-management/post-event): Certificates, payouts and closing an event out.
- [AI Event Creation](https://docs.vihaya.app/docs/event-management/ai-event-creation): Describing an event in plain English and having the form filled in for you.

## API Reference

- [Overview](https://docs.vihaya.app/docs/api): What the REST API covers, and the shape of a headless integration.
- [Authentication](https://docs.vihaya.app/docs/api/authentication): API keys: scoping, the two key types, origin pinning and revocation.
- [Taking Payment](https://docs.vihaya.app/docs/api/payments): The two-call registration flow and the Razorpay handoff in the middle of it.
- [Endpoints](https://docs.vihaya.app/docs/api/endpoints): Every endpoint with its exact fields and status codes, generated from the live spec.
- [SDKs](https://docs.vihaya.app/docs/api/sdks): Official clients for seven languages, what they wrap, and what they do not.
- [Webhooks](https://docs.vihaya.app/docs/api/webhooks): Signed callbacks when a registration confirms, and verifying the HMAC.
- [Tickets & QR](https://docs.vihaya.app/docs/api/tickets): What the QR actually contains, and how to send ticket emails from your own domain.