Retrieve my time day

Returns the caller's account-timezone day with canonical entries, privacy-safe attributed sessions, conflicts, gaps, timer, draft, totals, and submission state. Use `today` to resolve the account-local date.

GET/api/v1/time-days/:date

Authorization

time:read_selfapi key scoperequired

Required scope when calling with an API key.

Path parameters

datestringrequired

YYYY-MM-DD or today in the account timezone

Example: today

Request

GET /api/v1/time-days/:date

curl -X GET "https://www.digitalstack360.com/api/v1/time-days/today" \
  -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": {
    "work_date": "2026-07-14",
    "timezone": "America/New_York",
    "entries": [],
    "sessions": [],
    "conflicts": [],
    "gaps": [],
    "running_timer": null,
    "submission": null,
    "draft": null,
    "totals": {
      "entry_minutes": 0,
      "captured_minutes": 0,
      "proposed_minutes": 0
    }
  },
  "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

400

invalid_date

date is not today or a real YYYY-MM-DD date