# Ovadev API > REST API of TICKETOVA (ticketing) and JANUNA (hospitality point of sale) at https://api.ova.dev/v1, plus an MCP server at https://api.ova.dev/mcp. JSON over HTTPS, authenticated with `ova_sk_` (secret) or `ova_rk_` (restricted) API keys. Start with a restricted read-only key and confirm writes with the user. Amounts are integers in minor units (`*_amount`, currency `chf`). Send an `Idempotency-Key` on POST and DELETE (required on bookings). The MCP server accepts restricted keys only. Never put a key in logs or client code. ## Guides - [Introduction](/introduction.md) - [Quickstart](/quickstart.md) - [Authentication and keys](/authentication.md) - [Errors](/errors.md) - [Pagination](/pagination.md) - [Idempotency](/idempotency.md) - [Versions and changelog](/versioning.md) - [Rate limits](/rate-limits.md) - [Webhooks](/webhooks.md) - [MCP setup](/mcp-setup.md) - [Data protection](/data-protection.md) ## Shared resources - [Account](/account.md): The account the key belongs to: name, status, active products, languages, time zone and currency. A good first call to check a new key. - [Venues](/venues.md): The venues of the account with address, time zone and the start of the business day. Their `brn_` ids filter many other lists. A key limited to one venue sees only that one. - [Customers](/customers.md): Customers from shop and till with language, marketing consent and the figures of their TICKETOVA orders. This is personal data: grant `customers:read` only where it is needed. - [Vouchers and cards](/vouchers.md): Gift cards and stored-value cards with balance, held amounts and every movement (issue, top-up, redemption). A card code is never returned, only its last four characters. - [Webhook endpoints](/webhook-endpoints.md): HTTPS targets Ovadev sends signed events to. Creating one returns the signing secret `whsec_…` exactly once; at most 10 endpoints per account. Receiving and verifying deliveries is described in the Webhooks guide. - [Events](/events.md): The event log of the last 7 days with the same payload a webhook delivery carries. Events are recorded only while an endpoint subscribes to their type. The `id` is the `event_id` of the deliveries. ## TICKETOVA - [Catalogue](/ticketova-catalog.md): The ticket catalogue: products such as day and season tickets with their price levels, plus seasons and events. - [Orders](/ticketova-orders.md): Orders from shop, till and dashboard with items, payments and refunds, plus the top-up credits. Read-only: refunds stay in the dashboard. - [Tickets](/ticketova-tickets.md): Issued tickets with validity and status. Locking and unlocking are the only writes; over MCP, locking needs `confirm` set to the ticket id. - [Entries](/ticketova-scans.md): Scans at gates and scanners with time, device and verdict, for visitor counts and reporting. - [Partners](/ticketova-partners.md): Partners such as schools, clubs or companies and their partner codes. - [Group orders](/ticketova-group-orders.md): Group orders on invoice. Creating one is a booking and requires an Idempotency-Key. ## JANUNA - [Catalogue](/januna-catalogue.md): JANUNA articles, categories, modifier groups and menus with names in several languages and prices. - [Receipts](/januna-receipts.md): Fiscal receipts of the tills (sale, correction, cancellation, refund) with lines, VAT and payments. Immutable and read-only. - [Day closings](/januna-closings.md): Sealed day closings (Z reports) per venue with totals by tender, VAT rate and category. - [Sales](/januna-sales.md): Daily and hourly sales per venue and the status of the business days, for controlling, forecasting and rostering. - [Reservations](/januna-reservations.md): Push reservations from a reservation system (upsert) and read them. - [Takeaway orders](/januna-takeaway-orders.md): Takeaway orders from the JANUNA store. - [Account customers](/januna-account-customers.md): Account customers whose consumption is invoiced to them. Creating and updating them is allowed. - [Account invoices](/januna-account-invoices.md): The invoices of the account customers, read-only. ## MCP - [MCP server](/mcp.md): One endpoint for AI assistants following the Model Context Protocol (Streamable HTTP). Every public operation the key may call is a tool. Restricted keys `ova_rk_…` only; setup is described in the MCP setup guide. ## Optional - [llms-full.txt](/llms-full.txt): All docs in one file - [openapi.json](/openapi.json): OpenAPI 3 document of the public API - [German version](/de/llms.txt)