List invitations

Requires your secret key, or a JWT owner crossing into their own tenant. Returns every invitation ever created, most recent first - used and expired ones included, not just the outstanding ones. Filter on isUsed/isExpired yourself if you only want to show what’s still actionable.

const invitations = await kerne.invitations.list();

console.log('Tokens:', invitations.tokens);
console.log('Codes:', invitations.codes);

{
  "tokens": [
    {
      "id": "inv_123",
      "email": "[email protected]",
      "token": "eyJhbGciOi...",
      "type": "token",
      "isUsed": false,
      "isExpired": false,
      "expires_at": "2026-09-02T00:00:00.000Z",
      "created_at": "2026-08-26T00:00:00.000Z",
      "created_by": "user_456"
    }
  ],
  "codes": [
    {
      "id": "code_789",
      "code": "7HK4RXPQ",
      "type": "code",
      "isUsed": false,
      "isExpired": false,
      "max_uses": 100,
      "used_count": 5,
      "expires_at": null,
      "created_at": "2026-08-26T00:00:00.000Z",
      "created_by": "user_456"
    }
  ]
}

A code’s isUsed means fully redeemed (used_count >= max_uses), not that it’s gone - see Validate for the same distinction at redemption time.

Server SDK

Frontend SDKs

List invitations