API overview

Base URL, keys, versioning, errors, pagination and idempotency.

Base URL: https://api.konec.to/v1
Format:   JSON over HTTPS
Spec:     https://api.konec.to/v1/openapi.json

Two surfaces

	Public API	Admin API
Path	/v1/public/...	/v1/...
Credential	Publishable key, allowed origins only	Secret key or OAuth token
Use from	Browsers, event sites, components	Servers, MCP, integrations

curl https://api.konec.to/v1/events \
  -H "Authorization: Bearer sk_live_..."

{ "error": { "code": "ticket_sold_out", "message": "Standard is sold out.", "request_id": "req_7Hk..." } }

HTTP	Meaning
400	Invalid request
401	Missing or invalid credential
403	Missing scope, or module not enabled (`module_required`)
404	Not found
409	Conflict, for example sold out or already checked in
429	Rate limited

List endpoints accept limit (up to 100) and cursor, and return next_cursor.

Send an Idempotency-Key header on every write. Repeating a request with the same key returns the first result.

events:read, events:write, orders:read, orders:refund, pages:write, domains:buy, finance:read, finance:write, tasks:read, tasks:write, analytics:read