Pagination

All list endpoints return a bare JSON array, sorted newest first (descending createdAt).

[
  { "id": "cl_4f9a…", "name": "Acme Corp", … },
  { "id": "cl_8b2e…", "name": "Globex", … },
  …
]

Query parametersCopy Anchor Link

Example — fetch up to 50 clients:

curl "https://usekwill.com/api/v1/clients?limit=50" \
  -H "Authorization: Bearer $KWILL_API_KEY"

Fetching all recordsCopy Anchor Link

There is no cursor or page parameter. If you need every record, request with limit=500 and collect the result. For most workspaces, a single call is sufficient.

async function fetchAll(path) {
  const res = await fetch(
    `https://usekwill.com/api/v1${path}?limit=500`,
    { headers: { Authorization: `Bearer ${process.env.KWILL_API_KEY}` } }
  );
  return res.json();
}

const allClients = await fetchAll('/clients');

FilteringCopy Anchor Link

Some endpoints accept additional query parameters to filter results: