List Time Entries

Returns a paginated list of time entries for the authenticated account, ordered by date descending.

GET /api/v1/time-entries

cURL

curl "https://kliio.app/api/v1/time-entries?date_from=2025-03-01&date_to=2025-03-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "data": [
    {
      "id": "te-uuid-...",
      "hours": 3,
      "hourly_rate": 120,
      "date": "2025-03-20",
      "description": "Wireframing",
      "project": { "id": "proj-uuid-...", "name": "Acme Rebrand" },
      "task": { "id": "task-uuid-...", "name": "Design homepage mockup" },
      "created_at": "2025-03-20T18:00:00.000Z"
    }
  ],
  "pagination": { "total": 38, "limit": 50, "offset": 0 }
}

Headers

Authorization · string · required

Bearer YOUR_API_KEY

Query Parameters

project_id · string

Filter by project UUID.

task_id · string

Filter by task UUID.

date_from · string

Return entries on or after this date (YYYY-MM-DD).

date_to · string

Return entries on or before this date (YYYY-MM-DD).

limit · integer

Records per page. Default 50, max 100.

offset · integer

Records to skip. Default 0.

Response

data · array

List of time entry objects.

Show Time entry object

id · string

Entry UUID

hours · number

Hours logged

hourly_rate · number

Hourly rate at time of logging (nullable)

date · string

Date of work in YYYY-MM-DD format

description · string

Entry description (nullable)

project · object

Embedded project (id, name)

task · object

Embedded task (id, name) — nullable if not linked to a task

created_at · string

ISO 8601 timestamp

pagination · object

Show Properties

total · integer

Total matching records

limit · integer

Page size used

offset · integer

Offset used

cURL

curl "https://kliio.app/api/v1/time-entries?date_from=2025-03-01&date_to=2025-03-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "data": [
    {
      "id": "te-uuid-...",
      "hours": 3,
      "hourly_rate": 120,
      "date": "2025-03-20",
      "description": "Wireframing",
      "project": { "id": "proj-uuid-...", "name": "Acme Rebrand" },
      "task": { "id": "task-uuid-...", "name": "Design homepage mockup" },
      "created_at": "2025-03-20T18:00:00.000Z"
    }
  ],
  "pagination": { "total": 38, "limit": 50, "offset": 0 }
}