List my time entries

Lists canonical time entries owned by the authenticated principal. The user identity is credential-derived and cannot be overridden.

GET/api/v1/time-entries

Authorization

time:read_selfapi key scoperequired

Required scope when calling with an API key.

Query parameters

startstringoptional

Inclusive work date, YYYY-MM-DD

Example: 2026-07-01

endstringoptional

Inclusive work date, YYYY-MM-DD

Example: 2026-07-14

project_idstringoptional

Filter by a project in the resolved workspace

Example: proj_abc123

statusstringoptional

Filter by canonical approval status

Example: draft

limitnumberoptional

Maximum entries, 1–100

Example: 50

Request

GET /api/v1/time-entries

curl -X GET "https://www.digitalstack360.com/api/v1/time-entries" \
  -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": "time_01k2...",
      "work_date": "2026-07-14",
      "duration_minutes": 90,
      "billable_status": "billable",
      "category_key": "client_delivery",
      "notes": "Implemented retry handling",
      "target_type": "project",
      "target_id": "proj_abc123",
      "project_id": "proj_abc123",
      "status": "draft",
      "version": 1,
      "source": {
        "kind": "manual",
        "external_source": null,
        "external_id": null
      },
      "created_at": "2026-07-14T18:22:04Z",
      "updated_at": "2026-07-14T18:22:04Z"
    }
  ],
  "meta": {
    "limit": 50,
    "count": 1,
    "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

start or end is not a real YYYY-MM-DD calendar date

400

invalid_date_range

start occurs after end

400

invalid_limit

limit is not an integer from 1 through 100