List entitlements

Useful for a “your plan” or settings screen, without one useAccess per feature. Like the rest of the client SDK, there’s no customer parameter - it’s always the currently authenticated user’s own customer.

import { useEntitlements } from '@kerne/react';

function PlanSummary() {
  const { entitlements, isLoading } = useEntitlements();

  if (isLoading || !entitlements) return <Spinner />;

  return (
    <ul>
      {entitlements.entitlements.map((e) => (
        <li key={e.feature_key}>
          {e.feature_key}: {e.feature_type === 'QUOTA' ? `${e.used}/${e.limit ?? '∞'}` : e.enabled ? 'on' : 'off'}
        </li>
      ))}
    </ul>
  );
}

There’s no allowed field per entry here, unlike useAccess - this response is cached for 60s server-side, and a stale “allowed” verdict on a QUOTA feature would be unsafe. Use this hook to render state (a meter, a list of what’s included), and useAccess for the actual go/no-go decision before an action.

entitlements.subscription_status and entitlements.plan_slug are also on the response, for a header like “Pro plan - active”.

Server SDK

Frontend SDKs

List entitlements