GET /v2/counters

Returns an array of flat Counter objects for the authenticated user.

curl -H "Authorization: Bearer YOUR_TOKEN" https://developers.counttogether.app/v2/counters?timezone=Europe/Berlin

Query Parameters

Parameter	Required	Description
timezone	No	IANA timezone name (e.g. `Europe/Berlin`). Falls back to the user's account timezone. Used to resolve `value` for date counters.

Successful Response (200)

[
  {
    "id": "018f5b54-9b11-7c33-b347-a2b4e2a6a111",
    "name": "Daily Steps",
    "type": "UpDown",
    "value": 12450,
    "created": "2025-01-01T00:00:00Z"
  },
  {
    "id": "018f5b54-9b11-7c33-b347-a2b4e2a6a222",
    "name": "Running Streak",
    "type": "FromDate",
    "startDate": "2025-01-01",
    "value": 45,
    "created": "2025-01-01T00:00:00Z"
  },
  {
    "id": "018f5b54-9b11-7c33-b347-a2b4e2a6a333",
    "name": "Year End",
    "type": "ToDate",
    "endDate": "2025-12-31",
    "value": 180,
    "created": "2025-01-01T00:00:00Z"
  }
]

Field Reference

Field	Type	Description
id	string (UUID v7)	Unique counter identifier
name	string	Human readable name (5..40 chars)
type	enum `UpDown` \\|`FromDate` \\|`ToDate`	Counter category
value	number	For UpDown: current numeric value. For FromDate: past days. For ToDate: remaining days. Resolved using the timezone parameter.
startDate	string (date)	Only present for `FromDate` counters
endDate	string (date)	Only present for `ToDate` counters
created	string (ISO 8601 UTC)	When the counter was created

Empty Result

If the user owns or shares no counters, the endpoint returns [].

Authentication Errors

Missing / invalid token → 401 Unauthorized

21 April 2026