KintsugiKintsugi

List organization users

GET/users

List the people attached to one organization: its members, plus anyone who has been invited and has not accepted yet (status PENDING). Rows are ordered by email. Requires a user credential (an API key is rejected) that is an Owner or Admin of the organization. Select a client organization with Organization-Id; omit Organization-Id when the bearer is an Owner or Admin of exactly one portfolio to list the partner firm team instead. Pass limit and the opaque cursor from a prior response's nextCursor to page forward; hasMore is false on the last page.

Authorization

AuthorizationstringRequired

A signed-in user's session token, sent as Authorization: Bearer <token>. It authorizes the organizations that user can reach. Operations that manage people accept only this credential; operations on data also accept an API key.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target client organization. Omit to manage the partner firm team when the bearer is an Owner or Admin of exactly one portfolio.

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Query

Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.

/users?limit=<limit>&cursor=<cursor>
limitinteger

Maximum number of items to return.

cursorstring

Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.

Response

itemsOrgUser[]Required

Users on this page, ordered by email.

nextCursorstring

Opaque cursor for the next page, or null on the last page. Echo it as the request cursor to page forward. Pages are not a stable snapshot: if the roster changes while you walk it, a user can shift across a page boundary and be seen twice or missed.

previousCursorstring

Always null: this roster pages forward only.

hasMoreboolean

Whether a next page exists.

hasPreviousboolean

Always false: this roster pages forward only.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

422

The request failed validation.

503

A service this request depends on was unavailable. Retry the request.

cURL
GET /users?limit=50&cursor={cursor}
-H "Authorization: Bearer ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/users?limit=50&cursor={cursor}
Response
{
"items": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"organizationId": "orgn_2mNpQr7Ls8f3k",
"email": "jane.doe@example.com",
"role": "OWNER",
"status": "ACTIVE",
"firstName": "Jane",
"lastName": "Doe",
"createdAt": "2026-07-28T12:00:00Z"
}
],
"nextCursor": "eyJpZCI6InRyYW5fMm1OcFFyN0xzOGYzayJ9",
"previousCursor": "eyJpZCI6InRyYW5fMm1OcFFyN0xzOGYzayJ9",
"hasMore": false,
"hasPrevious": false
}
List organization users (2026-07-21) | Kintsugi API Reference