Projects

Read projects owned by or shared with the authorized user, and resolve member names for assignment.

GET

/me

Returns the Klaarin user this key is authorized for, including workspace and plan. Use it to verify a key before anything else.

Query parameters

fieldsstringoptionalComma-separated field names to trim the response to

GET

/projects

Lists projects visible to the key’s user.

Query parameters

limitintegeroptionalPage size, default 25, max 100
offsetintegeroptionalNumber of results to skip, default 0
fieldsstringoptionalComma-separated field names to trim the response to
expandstringoptionalComma-separated relations to include in full — members

GET

/projects/{id}

Gets details of one project, including its member count.

Query parameters

fieldsstringoptionalComma-separated field names to trim the response to
expandstringoptionalComma-separated relations to include in full — members

GET

/projects/{id}/members

Lists a project’s members and owner — use this to resolve assignee names to IDs. Not paginated.

View example

List projects

curl https://klaarin.com/api/v1/projects \
  -H "Authorization: Bearer kl_live_9f2ac…"

Response

{
  "data": [
    {
      "id": 42,
      "name": "Klaarin - Development",
      "status": "active",
      "taskCount": 18,
      "createdAt": "2026-05-20T08:00:00.000Z"
    }
  ],
  "meta": { "total": 12, "limit": 25, "offset": 0, "hasMore": false }
}