License Tiers

Each Releval deployment runs under a license that defines a tier and a set of resource limits. The tier is selected at license issuance time. Three tiers are defined.

Tiers and limits

Limit	Individual	Team	Enterprise
Members	1	10	Unlimited
App clients	1	10	Unlimited
Search endpoints	1	Unlimited	Unlimited
Query sets	Unlimited	Unlimited	Unlimited
Query templates	Unlimited	Unlimited	Unlimited
Evaluations	Unlimited	Unlimited	Unlimited
Judgment lists	Unlimited	Unlimited	Unlimited

"Unlimited" means the license imposes no cap; ordinary database/storage capacity still applies.

The unlicensed fallback (no license file installed) behaves like an evaluation tier with permissive defaults — fine for trying Releval out, not intended for production use.

How limits are enforced

Resource limits are checked when you create new resources. If you're at the cap for a given resource type, the API returns 403 Forbidden with a problem-detail body explaining which limit was reached. Existing resources are not affected.

For example, attempting to invite an 11th member on a Team tier returns:

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.3",
  "title": "Limit reached",
  "status": 403,
  "detail": "Member limit (10) reached on Team tier."
}

Viewing current tier and usage

The license endpoint returns the active tier, expiration, and licensee details:

curl "https://${RELEVAL_HOST}/api/v1/license" \
  -H "Authorization: Bearer ${TOKEN}"

The limits endpoint returns the per-resource cap and your current usage:

curl "https://${RELEVAL_HOST}/api/v1/license/limits" \
  -H "Authorization: Bearer ${TOKEN}"

The response uses null to indicate "unlimited" for that resource.

Upgrading

To change tiers, contact your license provider for a new license file. Once issued:

1. Place the new license file at the path specified by LICENSING__LICENSEFILEPATH (see Licensing configuration).
2. Restart Releval.
3. Verify the new tier with GET /api/v1/license.

Choosing a tier

You're…	Pick
Evaluating Releval as a single user, or running a personal proof-of-concept	Individual
A small team (up to ten members) iterating on search relevance for a single product	Team
An organisation with multiple teams, many endpoints, or unlimited member count	Enterprise

If you're not sure, start on Individual. Limits are enforced live, so you'll get a clear 403 if you outgrow the tier — no silent surprises.