Get my active timer

Returns the authenticated principal’s active canonical timer and net elapsed state, or null.

GET/api/v1/time-timer

Authorization

time:read_selfapi key scoperequired

Required scope when calling with an API key.

Request

GET /api/v1/time-timer

curl -X GET "https://www.digitalstack360.com/api/v1/time-timer" \
  -H "Authorization: Bearer $DS_API_KEY"

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "id": "timer_01k2...",
    "started_at": "2026-07-14T18:00:00Z",
    "elapsed_seconds": 1320,
    "state": "running",
    "category_key": "client_delivery",
    "project_id": "proj_abc123",
    "version": 1
  },
  "meta": {
    "self_scoped": true
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks time:read_self scope