CountTogether Public API Overview
Welcome to the official CountTogether Public API documentation. This API allows you to access counters that belong to an authenticated user and receive realtime updates via WebSocket.
Base URL: https://developers.counttogether.app Current REST version: v2 (e.g. /v2/counters).
Playground
Ready-to-use SDKs
Feature Highlights
Retrieve your counters with a single endpoint.
Flat, typed counter response (
UpDown,FromDate,ToDate).Timezone-aware date counter values in both REST and WebSocket responses.
Partial updates via PATCH with type-gated field validation.
Increment / decrement by a custom amount.
Realtime server → client push via WebSocket.
Bearer token authentication with per-user sliding window rate limiting.
Consistent, structured error responses with numeric codes.
Versioning Strategy
The API uses a path-based version prefix (v1, v2). Breaking changes introduce a new version while older versions remain available for a defined deprecation window.
Stability
The v2 surface is considered stable. Experimental additions will be marked explicitly inside their section.