> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.anzi.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Get guarantee by UID

> Returns a guarantee by its UID for the provided license.



## OpenAPI

````yaml /openapi.yaml get /guarantees/info
openapi: 3.0.3
info:
  title: Anzi Backend API
  version: 1.0.0
  description: |
    API reference for Anzi. This spec is scoped to the Organizations module.
servers:
  - url: https://sandbox-api.anzi.finance/v1
    description: Sanbox
  - url: https://api.anzi.finance/v1
    description: Production
security: []
tags:
  - name: Licenses
    description: Operational licenses
  - name: Users
    description: Manage users and API keys
  - name: Claims
    description: Manage claims
paths:
  /guarantees/info:
    get:
      tags:
        - Guarantees
      summary: Get guarantee by UID
      description: Returns a guarantee by its UID for the provided license.
      parameters:
        - in: query
          name: uid
          required: true
          schema:
            type: string
          description: Guarantee UID
        - in: query
          name: license
          required: true
          schema:
            type: string
          description: License UID
      responses:
        '200':
          description: Guarantee found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GuaranteeEntity'
              examples:
                example:
                  value:
                    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'
                    loanAmount: 50000
                    type: 0
                    premiumPercentage: 3.5
                    coveragePercentage: 50
                    externalReference: CR-000001-XYZ
                    isNovation: false
        '400':
          description: Bad request (validation)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                GE_00:
                  value:
                    code: GE_00
                    message: Bad Request
        '401':
          description: Unauthorized (invalid API key)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                AUTH_01:
                  value:
                    code: AUTH_01
                    message: Invalid API Key
        '404':
          description: Guarantee or license not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                GE_03:
                  value:
                    code: GE_03
                    message: Guarantee not found
                LI_00:
                  value:
                    code: LI_00
                    message: License Not Found
      security:
        - apiKeyAuth: []
components:
  schemas:
    GuaranteeEntity:
      type: object
      properties:
        uid:
          type: string
          description: Unique identifier of the guarantee.
        tokenId:
          type: number
          description: Numeric identifier assigned to the guarantee token.
        coverage:
          type: number
          description: >-
            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:
          type: string
          format: date-time
          description: Date and time when the credit was disbursed.
        claimDate:
          type: string
          format: date-time
          nullable: true
          description: >-
            Date and time when a claim was registered for this guarantee (if
            any).
        dueDate:
          type: string
          format: date-time
          description: Guarantee due date.
        status:
          type: integer
          enum:
            - 0
            - 1
            - 2
            - 3
            - 4
            - 5
            - 6
            - 7
            - 8
            - 9
            - 10
          description: >-
            0=PENDING_ACTIVATION, 1=VALIDATING_PREMIUM_PAYMENT, 2=COVERING,
            3=PENDING_CLAIM, 4=CLAIM_APPROVED, 5=PAYING_GUARANTEE, 6=CLOSED,
            7=CLAIM_REJECTED, 8=CANCELED, 9=NOVATED, 10=REVOKED
        creditStatus:
          type: integer
          enum:
            - 0
            - 1
            - 2
            - 3
            - 4
            - 5
          description: >-
            0=CURRENT, 1=DELINQUENT, 2=CLAIM_GUARANTEE, 3=NOVATED, 4=PAID,
            5=REVOKED
        creditStatusUpdatedAt:
          type: string
          format: date-time
          description: Timestamp of the last update to creditStatus.
        creditPrincipalOutstanding:
          type: number
          description: >-
            Outstanding principal amount of the credit as of the borrower’s last
            payment date.
        creditLastPaymentDate:
          type: string
          format: date-time
          nullable: true
          description: Date and time of the last credit payment (if any).
        premiumStatus:
          type: integer
          enum:
            - 0
            - 1
            - 2
          description: 0=PENDING, 1=PROCESSING, 2=PAID
        premium:
          type: number
          description: Premium amount charged for the guarantee (monetary value).
        principalName:
          type: string
          description: Borrower or principal name associated with the credit.
        loanPaymentDueDate:
          type: string
          format: date-time
          description: >-
            Date and time when the loan payment is/was completed by the
            borrower.
        loanAmount:
          type: number
          description: Original loan principal amount linked to this guarantee.
        type:
          type: integer
          enum:
            - 0
            - 1
          description: >-
            0 = SURETY, 1 = FIRST_LOSS. License type under which this guarantee
            was created.
        premiumPercentage:
          type: number
          description: Percentage applied to the loan amount to compute the premium.
        coveragePercentage:
          type: number
          description: >-
            Percentage of the principal amount that is covered by the guarantee.
            For guarantees created under FIRST LOSS licenses (license.type =
            FIRST_LOSS), coverage is equal the loan amount but it depends
            exclusively on the amount the user has in their own reserve fund
            (wallet).
        externalReference:
          type: string
          description: >-
            Unique credit reference in your system used to identify the
            guarantee.
        isNovation:
          type: boolean
          description: >-
            Indicates if this guarantee results from a novation of a prior
            guarantee.
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````