Introduction

The Tixxy API lets your software read and create events, ticket types, orders and tickets, check tickets in and receive webhooks when something happens. It is a JSON REST API at https://api.tixxy.nl/v1.

Quickstart

Create a token

An administrator of the organisation creates a token at Organisation > Settings > API in Tixxy. Start with a test token: it only touches test data and costs nothing.

Make your first request

curl https://api.tixxy.nl/v1/me \
  -H "Authorization: Bearer tixxy_test_..."

The response tells you which organisation the token belongs to, which scopes it has and your rate limits.

List your events

curl "https://api.tixxy.nl/v1/events?limit=10" \
  -H "Authorization: Bearer tixxy_test_..."

Principles

One token, one organisation. A token only ever sees the organisation it was created in.
Never more than its owner. Every request is checked against the token's scopes and the live permissions of the person who created it, including their event restrictions.
Stable contract. Fields are only added in /v1. Breaking changes get a new version.
Amounts in cents, times in UTC. 2500 means EUR 25.00; timestamps are ISO 8601 in UTC.
Prefixed ids. Objects have ids like evt_01J..., ord_01J... and tkt_01J....