List Projects

Returns all projects belonging to the authenticated account, ordered by creation date descending.

GET /api/v1/projects

cURL

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

200

{
  "data": [
    {
      "id": "proj-uuid-...",
      "name": "Acme Rebrand",
      "status": "active",
      "client": {
        "id": "c1d2e3f4-...",
        "name": "Alice Johnson",
        "email": "[e-mail]",
        "company_name": "Acme Corp"
      },
      "created_at": "2025-02-10T08:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Headers

Authorization · string · required

Bearer YOUR_API_KEY

Query Parameters

status · string

Filter by project status. Uses your workspace’s custom statuses if configured, or defaults like In Progress, Awaiting Approval, Complete.

client_id · string

Filter projects by client UUID.

limit · number · default: "50"

Maximum number of records to return (max 100).

offset · number · default: "0"

Number of records to skip.

Response

data · array

List of project objects.

Show Project object

id · string

Project UUID

name · string

Project name

status · string

Project status

client · object

Embedded client (id, name, email, company_name)

created_at · string

ISO 8601 timestamp

description · string

Project brief or description (nullable)

pagination · object

Show Pagination metadata

total · number

Total records matching the filters

limit · number

Records per page

offset · number

Number of skipped records

cURL

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

200

{
  "data": [
    {
      "id": "proj-uuid-...",
      "name": "Acme Rebrand",
      "status": "active",
      "client": {
        "id": "c1d2e3f4-...",
        "name": "Alice Johnson",
        "email": "[e-mail]",
        "company_name": "Acme Corp"
      },
      "created_at": "2025-02-10T08:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}