How Billing Works
Admin, grant, and credit access modes plus reservation and consumption rules.
Assessment access is resolved through three effective modes: admin, grant,
and credits.
Admin mode
If the user is an admin:
- access is allowed
- session credit reservation is skipped
- report credit consumption is skipped
This is an intentional bypass path for operators and support staff.
Grant mode
If the user or their organization has an active time-based access grant:
- access is allowed
- session credit reservation is skipped
- report credit consumption is skipped
Grants are useful for pilots, enterprise rollouts, and time-boxed product access.
Credits mode
If the user or organization has available credits:
- access is allowed
- one credit is reserved when the session becomes active
- the credit is consumed when the final report is issued
See How assessments work for the assessment and
report lifecycle tied to credit usage.
Reservation vs consumption
These are different steps.Reservation happens when a session is created or activated. It prevents the
same available credit from being treated as free across multiple active sessions.
Consumption happens when the final report is issued. The product first tries
to charge the reserved session credit, then falls back to available user or
organization credit by configured priority.
Organization priority
If the user belongs to an organization, credit usage can prefer organization credits first or user credits first, depending on the organization'screditPriority setting.
What the user sees
The credits endpoint exposes:- user credits available
- user credits reserved
- organization credits available
- organization credits reserved
- active time-based access grants