CountTogether Public API Help

v1 API — Deprecation Notice

All v1 endpoints will continue to function until the sunset date, but responses will include the following headers:

Deprecation: true Sunset: Tue, 01 Jul 2026 00:00:00 GMT Link: <https://developers.counttogether.app/topics/overview.html>; rel="successor-version"

Migration to v2

The v2 API uses a flat response format with timezone-aware counter values and expanded PATCH/increment semantics.

v1

v2 Equivalent

GET /v1/counters

GET /v2/counters?timezone=

GET /v1/counters/{id}

GET /v2/counters/{id}?timezone=

POST /v1/counters/{id}/increment

POST /v2/counters/{id}/increment

POST /v1/counters/{id}/decrement

POST /v2/counters/{id}/decrement

PUT /v1/counters/{id}

PATCH /v2/counters/{id}

GET /v1/ws

GET /v2/ws?timezone=

Key Response Differences

  • v2 uses a flat counter shape: { id, name, type, value, startDate?, endDate?, created } instead of the nested { id, displayName, type, members, data } shape of v1.

  • value is timezone-resolved in v2: for FromDate counters it is pastDays, for ToDate it is remainingDays, both calculated for the requested timezone.

  • name replaces displayName.

  • members are no longer included in v2 counter responses.

See GET /v2/counters for the full v2 reference.

21 April 2026
PATCH /v2/counters/{counterId}WebSocket Realtime API