Check access

Use this guide when you already have a customer mapped to a plan version and want to gate one feature in your app.

Replace plan branches with feature checks

Without Unprice, pricing logic often leaks into product code:

if (customer.plan === "PRO") {
  return runTokenGeneration();
}

return new Response("Upgrade required", { status: 403 });

With Unprice, your code checks the feature slug. The customer’s plan version and entitlement state stay outside the product branch.

const { result, error } = await unprice.access.check({
  customerId: customer.unpriceCustomerId,
  featureSlug: "ai-messages"
});

if (error) {
  throw new Error(error.message);
}

if (!result.allowed) {
  return new Response("Feature unavailable", { status: 403 });
}

return runTokenGeneration();

Report or enforce usage

Use usage.record when you only need async usage evidence:

await unprice.usage.record({
  customerId: customer.unpriceCustomerId,
  eventSlug: "completions",
  idempotencyKey: request.id,
  properties: {
    aiMessages: 1,
    aiGenerations: 2,
    aiTools: 3,
    inputTokens: 1840,
    outputTokens: 620
  }
});

Use usage.consume when the request path must deny over-limit or over-budget usage:

const { result, error } = await unprice.usage.consume({
  customerId: customer.unpriceCustomerId,
  featureSlug: "ai-messages",
  eventSlug: "completions",
  idempotencyKey: request.id,
  properties: {
    aiMessages: 1,
    inputTokens: 1840,
    outputTokens: 620
  }
});

if (error) {
  throw new Error(error.message);
}

if (!result.allowed) {
  return new Response("Usage limit reached", { status: 429 });
}

Next steps

Choose the runtime call

Compare access.check, usage.record, usage.consume, and budgeted runs.

Access check SDK

See the full access.check request and response shape.

First customer Plans

Features

Concepts

Replace plan branches with feature checks

Report or enforce usage

Next steps

Choose the runtime call

Access check SDK

​Replace plan branches with feature checks

​Report or enforce usage

​Next steps

Choose the runtime call

Access check SDK

Replace plan branches with feature checks

Report or enforce usage

Next steps