Changelog

Notable changes to the public API. The spec's info.version is bumped with every change listed here.

1.5.0 — July 2026

• Claude connector: a remote MCP endpoint at POST /api/v1/mcp that lets Claude read and manage a club's data through the same scopes as an API key. Connect claude.ai in one click via the new OAuth 2.0 server (Dynamic Client Registration, PKCE S256), or point Claude Desktop/Code at the endpoint with a ct_live_… key.

1.4.2 — July 2026

• More webhook events: member.archived (membership ended) and payment.failed (direct-debit failed/charged back). Ids-only, as usual.

1.4.1 — July 2026

• New webhook events: event.registration (someone registers for a calendar event), charge.created and payment.received (membership-fee charges) — subscribe per endpoint as usual. Payloads stay ids-only.

1.4.0 — July 2026

• Facilities & reservations (read-only): the accommodation register (facilities:read) and the day occupancy/reservations (reservations:read) are now exposed — without member names, for website and integration use.

1.3.0 — July 2026

• Webhooks: signed push notifications (HMAC-SHA256) for member, event, attendance and trial-member changes — with retries, a delivery log and a test button in the app. See the webhooks guide.
• Sandbox keys: POST /api/v1/sandbox-keys mints a read-only ct_test_… key against the public demo club — explore the API without a Pro club.
• Tooling recipes on the getting-started page (Postman import, client generation).

1.2.0 — July 2026

• New read-only resources: charges (contribution charges for bookkeeping integrations, scope payments:read), tournaments (incl. disciplines, scope tournaments:read) and news (published club-wide posts only, scope news:read).
• Tournament schedules/standings remain out of contract (planned) — use the public share page via public_slug.

1.1.0 — July 2026

• Incremental sync: every resource now exposes updated_at, and list endpoints accept ?updated_since= (ISO-8601, UTC).
• New resource: kennismakers (trial members / intake pipeline) with scopes kennismakers:read and kennismakers:write — built for club-website signup forms.
• API keys can be created with an optional expiry date, and the app now shows per-key usage (requests/errors per day, last 30 days).

1.0.0 — July 2026

• Initial release of the public API (/api/v1).
• Resources: club (introspection), members (CRUD + mixed bulk), groups (read), events (CRUD), seasons (read), competition-teams (CRUD), attendance (read, upsert + bulk upsert).
• Club API keys with per-resource scopes; RFC 9457 errors; cursor pagination; idempotent bulk; per-key rate limits.
• Planned: competition match results (reserved).

Versioning policy

• Additive changes (new endpoints, new optional fields) can happen at any time — build your parser to ignore unknown response fields.
• Breaking changes only happen in a new path version (/api/v2) with a deprecation window on the old one.