Skip to main content
GET
/
licenses
/
all
List licenses
curl --request GET \
  --url https://sandbox-api.anzi.finance/v1/licenses/all \
  --header 'X-API-KEY: <api-key>'
[
  {
    "uid": "LIC-0001-XYZ",
    "name": "Operative License A",
    "tokenId": "123456",
    "coveragePercentage": 50,
    "maximumCoverage": 50000,
    "premium": 3.5,
    "active": true,
    "timezone": "America/Bogota",
    "maximumLoanTerm": "P18M",
    "minimumLoanTerm": "P1M",
    "daysForGuaranteesDueDate": 365,
    "minimumDaysToDeclareDefault": 190,
    "portfolioCoverageCap": 2000000,
    "portfolioCoverageUsed": 750000,
    "maximumLoanAmount": 15000,
    "minimumLoanAmount": 1000,
    "lastRevision": "2025-08-15T00:00:00.000Z",
    "validityPeriod": "P6M",
    "type": 0,
    "administrationFee": 0,
    "historicPremiums": 120000,
    "isVariablePremium": true,
    "maximumPremium": 5,
    "minimumPremium": 2.5,
    "taxRate": 0.19,
    "accountingEmails": [
      "[email protected]",
      "[email protected]"
    ],
    "billCycle": "P1M",
    "isPremiumDefinedByClient": true
  }
]
The response contains one or more licenses tied to your organization.

Authorizations

​
X-API-KEY
string
header
required

Response

List of licenses

​
uid
string

Unique identifier of the license.

​
name
string
​
tokenId
string

Identifier for NFT associated to the license.

​
coveragePercentage
number

For FIRST LOSS licenses (license.type = FIRST_LOSS), coverage depends exclusively on the amount the user has in their own reserve fund (wallet).

​
maximumCoverage
number

For FIRST LOSS licenses (license.type = FIRST_LOSS), coverage depends exclusively on the amount the user has in their own reserve fund (wallet).

​
premium
number

Percentage of the borrowed capital representing the premium to be paid.

​
active
boolean

Indicates if the license is active or not.

​
timezone
string

Reference to the location from which the time zone should be taken for license management.

​
maximumLoanTerm
string

Maximum duration of a loan in ISO 8601 duration format.

​
minimumLoanTerm
string

Minimum duration of a loan in ISO 8601 duration format.

​
daysForGuaranteesDueDate
number

The number of days after the surety.loanPaymentDueDate, during which the surety will still be valid.

​
minimumDaysToDeclareDefault
number

The number of days that must elapse since the last payment to declare a default.

​
portfolioCoverageCap
number

Total approved coverage amount for this license.

​
portfolioCoverageUsed
number

Total coverage issued to date, representing what has been spent from the authorized portfolio coverage cap on this license.

​
maximumLoanAmount
number

Maximum loan amount to be covered by Anzi.

​
minimumLoanAmount
number

Minimum loan amount to be covered by Anzi.

​
lastRevision
string<date-time>

ISO 8601 Date. Date of the last review of license configurations by the Anzi team.

​
validityPeriod
string

ISO 8601 duration. Validity period granted to the license since the last revision.

​
type
enum<integer>

0 = SURETY, 1 = FIRST_LOSS

Available options:
0,
1
​
administrationFee
number

Amount of the administration fee to be paid over the reserve fund, only valid for FIRST LOSS licenses (license.type = FIRST_LOSS).

​
historicPremiums
number

Accumulated premium history amount.

​
isVariablePremium
boolean

Indicates if the premium is variable.

​
maximumPremium
number

Maximum premium amount to be paid for coverage concept, only valid if license.isVariablePremium is true.

​
minimumPremium
number

Minimum premium amount to be paid for coverage concept, only valid if license.isVariablePremium is true.

​
taxRate
number

Tax rate to be applied to the premium amount.

​
accountingEmails
string<email>[]
Minimum array length: 1
​
billCycle
string

ISO 8601 duration for billing cycle (e.g., P1M).

​
isPremiumDefinedByClient
boolean

Indicates if the premium must be defined by the client.