List Clients

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

GET /api/v1/clients

cURL

curl https://kliio.app/api/v1/clients \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "data": [
    {
      "id": "c1d2e3f4-...",
      "name": "Alice Johnson",
      "email": "[e-mail]",
      "company_name": "Acme Corp",
      "status": "active",
      "created_at": "2025-03-15T10:30:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Headers

Authorization · string · required

Bearer YOUR_API_KEY

Query Parameters

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 client objects.

Show Client object

id · string

Client UUID

name · string

Full name of the client contact

email · string

Client email address

company_name · string

Company name (nullable)

phone · string

Phone number (nullable)

status · string

Client status (e.g. invited, active)

created_at · string

ISO 8601 timestamp

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/clients \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "data": [
    {
      "id": "c1d2e3f4-...",
      "name": "Alice Johnson",
      "email": "[e-mail]",
      "company_name": "Acme Corp",
      "status": "active",
      "created_at": "2025-03-15T10:30:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}