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",
    "tokenId": "123456",
    "accountingEmails": [
      "accounting@client.com",
      "billing@client.com"
    ],
    "active": true,
    "administrationFee": 0,
    "adminEmails": [
      "admin@client.com"
    ],
    "billCycle": "P1M",
    "coveragePercentage": 50,
    "daysForGuaranteesDueDate": 365,
    "historicPremiums": 120000,
    "installmentStrategy": "INSTALLMENT_COUNT",
    "installmentsEnabled": true,
    "isPremiumDefinedByClient": true,
    "isVariablePremium": true,
    "lastPortfolioUpdateDate": "2025-09-01T12:00:00.000Z",
    "lastRevision": "2025-08-15T00:00:00.000Z",
    "maximumCoverage": 50000,
    "maximumLoanAmount": 15000,
    "maximumLoanTerm": "P18M",
    "maximumPremium": 5,
    "minimumDaysToDeclareDefault": 190,
    "minimumLoanAmount": 1000,
    "minimumLoanTerm": "P1M",
    "minimumPremium": 2.5,
    "name": "Operative License A",
    "portfolioCoverageCap": 2000000,
    "portfolioCoverageUsed": 750000,
    "premium": 3.5,
    "taxRate": 0.19,
    "timezone": "America/Bogota",
    "type": 0,
    "validityPeriod": "P6M"
  }
]
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.

​
tokenId
string

Identifier for NFT associated to the license.

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

Indicates if the license is active or not.

​
administrationFee
number

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

​
adminEmails
string<email>[]

Administrative email recipients for license operations/notifications.

Minimum array length: 1
​
billCycle
string

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

​
coveragePercentage
number

For Surety licenses only (license.type = SURETY). This represents the maximum percentage that Anzi will cover for each loan.

​
daysForGuaranteesDueDate
number

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

​
historicPremiums
number

Accumulated premium history amount.

​
installmentStrategy
enum<string> | null

Installments strategy used when installments are enabled.

  • INSTALLMENT_COUNT: Strategy based on the number of installments (cuotas).
  • INSTALLMENT_AMOUNT: Strategy based on the installment amount (valor de la cuota).
Available options:
INSTALLMENT_COUNT,
INSTALLMENT_AMOUNT
​
installmentsEnabled
boolean | null

Indicates whether the license supports loan payments in installments.

​
isPremiumDefinedByClient
boolean

Indicates if the premium must be defined by the client when a guarantee is being created.

​
isVariablePremium
boolean

Indicates if the premium is variable.

​
lastPortfolioUpdateDate
string<date-time> | null

Timestamp of the last update sent to Anzi regarding the status of the portfolio loans.

​
lastRevision
string<date-time>

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

​
maximumCoverage
number

For Surety licenses only (license.type = SURETY). Maximum loan amount that can be covered by an Anzi guarantee.

​
maximumLoanAmount
number

Maximum loan amount to be covered by Anzi.

​
maximumLoanTerm
string

Maximum duration of a loan in ISO 8601 duration format.

​
maximumPremium
number

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

​
minimumDaysToDeclareDefault
number

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

​
minimumLoanAmount
number

Minimum loan amount to be covered by Anzi.

​
minimumLoanTerm
string

Minimum duration of a loan in ISO 8601 duration format.

​
minimumPremium
number

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

​
name
string
​
portfolioCoverageCap
number

For Surety licenses only (license.type = SURETY). Maximum total portfolio to be covered by this license.

​
portfolioCoverageUsed
number

For Surety licenses only (license.type = SURETY). Total value of the loans covered under this license., representing what has been spent from the authorized portfolio coverage cap on this license.

​
premium
number

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

​
taxRate
number

Tax rate to be applied to the premium amount.

​
timezone
string

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

​
type
enum<integer>

0 = SURETY, 1 = FIRST_LOSS

Available options:
0,
1
​
validityPeriod
string

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