Skip to main content
GET
/
guarantees
/
info
Get guarantee by UID
curl --request GET \
  --url https://sandbox-api.anzi.finance/v1/guarantees/info \
  --header 'X-API-KEY: <api-key>'
{
"uid": "a3f1c9e2-7b8d-4a6f-95e1-0c2b3d4e5f6a",
"tokenId": 987654321,
"coverage": 25000,
"disbursementDate": "2025-09-05T00:00:00.000Z",
"claimDate": null,
"dueDate": "2026-12-04T23:59:59.999Z",
"status": 2,
"premiumStatus": 2,
"premium": 1750,
"principalName": "Empresa XYZ SAS",
"loanPaymentDueDate": "2025-12-05T23:59:59.999Z",
"interestRate": 24.5,
"loanAmount": 50000,
"type": 0,
"premiumPercentage": 3.5,
"coveragePercentage": 50,
"externalReference": "CR-000001-XYZ",
"isNovation": false
}

Authorizations

X-API-KEY
string
header
required

Query Parameters

uid
string
required

Guarantee UID

license
string
required

License UID

Response

Guarantee found

uid
string

Unique identifier of the guarantee.

tokenId
number

Numeric identifier assigned to the guarantee token.

coverage
number

Maximum amount payable if the linked loan defaults. For guarantees created under FIRST LOSS licenses (license.type = FIRST_LOSS), coverage depends exclusively on the amount the user has in their own reserve fund (wallet).

disbursementDate
string<date-time>

Date and time when the credit was disbursed.

claimDate
string<date-time> | null

Date and time when a claim was registered for this guarantee (if any).

dueDate
string<date-time>

Guarantee due date.

status
enum<integer>

0=PENDING_ACTIVATION, 1=VALIDATING_PREMIUM_PAYMENT, 2=COVERING, 3=PENDING_CLAIM, 4=CLAIM_APPROVED, 5=PAYING_GUARANTEE, 6=CLOSED, 7=CLAIM_REJECTED, 8=CANCELLED, 9=NOVATED

Available options:
0,
1,
2,
3,
4,
5,
6,
7,
8,
9
creditStatus
enum<integer>

0=CURRENT, 1=DELINQUENT, 2=CLAIM_GUARANTEE, 3=NOVATED, 4=PAID

Available options:
0,
1,
2,
3,
4
creditStatusUpdatedAt
string<date-time>

Timestamp of the last update to creditStatus.

creditPrincipalOutstanding
number

Outstanding principal amount of the credit as of the borrower’s last payment date.

creditLastPaymentDate
string<date-time> | null

Date and time of the last credit payment (if any).

premiumStatus
enum<integer>

0=PENDING, 1=PROCESSING, 2=PAID

Available options:
0,
1,
2
premium
number

Premium amount charged for the guarantee (monetary value).

principalName
string

Borrower or principal name associated with the credit.

loanPaymentDueDate
string<date-time>

Date and time when the loan payment is/was completed by the borrower.

interestRate
number | null

Credit interest rate used by the client (optional).

loanAmount
number

Original loan principal amount linked to this guarantee.

type
enum<integer>

0 = SURETY, 1 = FIRST_LOSS. License type under which this guarantee was created.

Available options:
0,
1
premiumPercentage
number

Percentage applied to the loan amount to compute the premium.

coveragePercentage
number

Percentage of the principal amount that is covered by the guarantee. For guarantees created under FIRST LOSS licenses (license.type = FIRST_LOSS), coverage depends exclusively on the amount the user has in their own reserve fund (wallet).

externalReference
string

Unique credit reference in your system used to identify the guarantee.

isNovation
boolean

Indicates if this guarantee results from a novation of a prior guarantee.