Skip to main content

What is a License?

A License is the backbone of your interaction with Anzi. It defines the operational parameters that govern how your integration works with us. These parameters include, among others:
  • Coverage configuration and limits
  • Minimum/maximum loan amounts and terms
  • Conditions for default declaration
  • Total portfolio that can be guaranteed
  • Premium settings (fixed or variable, ranges and rules)
In short, the License tells Anzi how your guarantees will be structured and how they will be treated throughout their lifecycle.

License Types

There are two license types today, and we are working on adding more in order to unlock new guarantee use cases: See details, differences, and examples in License Types.
Learn more: License Types

How Many Licenses Can I Have?

Your Anzi account can have any number of licenses of any type. Each guarantee you create is associated with exactly one license, and the license’s configuration governs validations, limits, coverage, and premium behavior.

Who Manages Licenses?

Licenses are fully administered by Anzi. You cannot create or modify licenses directly. If you need an adjustment to your license configuration, please contact us at [email protected] or reach out to your account executive.

What is a License Revision?

(Applies only to Surety licenses) From time to time, Anzi reviews the performance of licenses within a specific period. Metrics such as default rate, coverage usage, and other parameters are analyzed, with the goal of adjusting coverage and guarantee pricing.

License Data

Below is a summary of the License schema fields and their meanings.
FieldTypeDescription
uidstringUnique identifier of the license.
namestringFriendly and understandable name for your license.
tokenIdstringIdentifier for NFT associated to the license.
coveragePercentagenumberFor FIRST LOSS licenses (license.type = FIRST_LOSS), coverage depends exclusively on the amount the user has in their own reserve fund (wallet).
maximumCoveragenumberFor FIRST LOSS licenses (license.type = FIRST_LOSS), coverage depends exclusively on the amount the user has in their own reserve fund (wallet).
premiumnumberPercentage of the borrowed capital representing the premium to be paid.
activebooleanIndicates if the license is active or not.
timezonestringReference to the location from which the time zone should be taken for license management.
maximumLoanTermstringMaximum duration of a loan in ISO 8601 duration format.
minimumLoanTermstringMinimum duration of a loan in ISO 8601 duration format.
daysForGuaranteesDueDatenumberThe number of days after the surety.loanPaymentDueDate, during which the surety will still be valid.
minimumDaysToDeclareDefaultnumberThe number of days that must elapse since the last payment to declare a default.
portfolioCoverageCapnumberTotal approved coverage amount for this license.
portfolioCoverageUsednumberTotal coverage issued to date, representing what has been spent from the authorized portfolio coverage cap on this license.
maximumLoanAmountnumberMaximum loan amount to be covered by Anzi.
minimumLoanAmountnumberMinimum loan amount to be covered by Anzi.
lastRevisionstring (date-time)ISO 8601 Date. Date of the last review of license configurations by the Anzi team.
validityPeriodstringISO 8601 duration. Validity period granted to the license since the last revision.
typeinteger0 = SURETY, 1 = FIRST_LOSS
administrationFeenumberAmount of the administration fee to be paid over the reserve fund, only valid for FIRST LOSS licenses (license.type = FIRST_LOSS).
historicPremiumsnumberAccumulated premium history amount.
isVariablePremiumbooleanIndicates if the premium is variable.
maximumPremiumnumberMaximum premium amount to be paid for coverage concept, only valid if license.isVariablePremium is true.
minimumPremiumnumberMinimum premium amount to be paid for coverage concept, only valid if license.isVariablePremium is true.
taxRatenumberTax rate to be applied to the premium amount.
accountingEmailsstring[]Accounting emails list. Must contain at least one email.
billCyclestringISO 8601 duration for billing cycle (e.g., P1M).
isPremiumDefinedByClientbooleanIndicates if the premium must be defined by the client.