# API overview

Section: API
Page: https://docs.konecto.ltd/api/overview

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

``text
Base URL: https://api.konecto.ltd/v1
Format:   JSON over HTTPS
Spec:     https://api.konecto.ltd/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 |

## Authentication
`bash
curl https://api.konecto.ltd/v1/events \
  -H "Authorization: Bearer sk_live_..."
`

## Errors
`json
{ "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 |

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

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

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