List Tasks

Returns a paginated list of tasks scoped to the authenticated account, across all projects.

GET /api/v1/tasks

cURL

curl "https://kliio.app/api/v1/tasks?status=in_progress" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "data": [
    {
      "id": "task-uuid-...",
      "name": "Design homepage mockup",
      "description": null,
      "status": "in_progress",
      "estimated_hours": 8,
      "billable": true,
      "rate": 120,
      "total_seconds": 10800,
      "phase_id": null,
      "project": { "id": "proj-uuid-...", "name": "Acme Rebrand" },
      "created_at": "2025-03-20T09:00:00.000Z"
    }
  ],
  "pagination": { "total": 12, "limit": 50, "offset": 0 }
}

Headers

Authorization · string · required

Bearer YOUR_API_KEY

Query Parameters

project_id · string

Filter tasks by project UUID.

status · string

Filter by task status. One of: todo, in_progress, done.

limit · integer

Records per page. Default 50, max 100.

offset · integer

Records to skip. Default 0.

Response

data · array

List of task objects.

Show Task object

id · string

Task UUID

name · string

Task name

description · string

Task description (nullable)

status · string

todo, in_progress, or done

estimated_hours · number

Estimated hours (nullable)

billable · boolean

Whether the task is billable

rate · number

Hourly rate for this task (nullable)

total_seconds · number

Total tracked seconds across all timers

phase_id · string

UUID of the assigned project phase (nullable)

project · object

Embedded project (id, name)

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/tasks?status=in_progress" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "data": [
    {
      "id": "task-uuid-...",
      "name": "Design homepage mockup",
      "description": null,
      "status": "in_progress",
      "estimated_hours": 8,
      "billable": true,
      "rate": 120,
      "total_seconds": 10800,
      "phase_id": null,
      "project": { "id": "proj-uuid-...", "name": "Acme Rebrand" },
      "created_at": "2025-03-20T09:00:00.000Z"
    }
  ],
  "pagination": { "total": 12, "limit": 50, "offset": 0 }
}