# tickts

> tickts is a UK ticketing platform for event organisers, with zero booking fees for fans and direct Stripe payouts to organisers. This file helps AI agents and tools discover the tickts REST API.

## API

The tickts REST API (v1) lets an organiser read and (on Pro) write their own data.

- Base URL: https://tickts.co.uk/api/v1
- OpenAPI spec: https://tickts.co.uk/openapi.json
- Auth: send your API key in the `X-TK-API-Key` header (or `Authorization: Bearer <key>`). Generate keys in Dashboard, Developers.
- Plans: read endpoints are available on every plan, including Free; write endpoints (create, update, refund, scan) need Pro.
- Rate limit: 60 requests per minute per key.

## Read endpoints (all plans, including Free)

- GET /api/v1/me — the authenticated organiser
- GET /api/v1/my/events — list your events
- GET /api/v1/my/events/{id} — a single event
- GET /api/v1/orders — list your orders
- GET /api/v1/orders/{id} — a single order
- GET /api/v1/tickets/validate/{code} — validate a ticket code
- GET /api/v1/venues — list your venues
- GET /api/v1/fans — list your fans / customers
- GET /api/v1/analytics/summary — sales analytics summary
- GET /api/v1/promos — list your promo codes

## Write endpoints (Pro only)

- POST /api/v1/events, PUT /api/v1/events/{id} — create / update events
- POST /api/v1/orders/{id}/refund — refund an order
- POST /api/v1/tickets/scan/{code} — scan a ticket
- POST /api/v1/venues, POST /api/v1/promos — create venues / promo codes
- GET / POST /api/v1/webhooks, DELETE /api/v1/webhooks/{id} — list / subscribe / unsubscribe webhook endpoints (HMAC-SHA256 signed deliveries via X-Tickts-Signature)

## More

- Pricing: https://tickts.co.uk/pricing
- Features: https://tickts.co.uk/features