> ## 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 claims by license (paginated)

> Returns claims associated to the authenticated license. Supports pagination and filtering by status and payment association.

Returns claims for the authenticated license. Use query params for pagination, sorting and filtering.


## OpenAPI

````yaml /openapi.yaml get /claims/guarantees
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:
  /claims/guarantees:
    get:
      tags:
        - Claims
      summary: Get claims by license (paginated)
      description: >-
        Returns claims associated to the authenticated license. Supports
        pagination and filtering by status and payment association.
      parameters:
        - in: query
          name: license
          required: true
          schema:
            type: string
          description: License UID
        - in: query
          name: page
          required: true
          schema:
            type: integer
            minimum: 1
          description: Page number (1-based)
        - in: query
          name: limit
          required: true
          schema:
            type: integer
            minimum: 1
          description: Page size (items per page)
        - in: query
          name: sort
          required: false
          schema:
            type: string
            enum:
              - asc
              - ascending
              - desc
              - descending
          description: Sort order by creation date
        - in: query
          name: status
          required: false
          schema:
            type: integer
            enum:
              - 0
              - 1
              - 2
              - 3
              - 4
          description: >-
            Claim status (0=PENDING_REVIEW, 1=APPROVED, 2=PROCESSING_PAYMENT,
            3=PAID, 4=REJECTED)
        - in: query
          name: hasNoAssociatedPayment
          required: false
          schema:
            type: boolean
          description: If true, returns only claims without associated payment
      responses:
        '200':
          description: Paginated list of claims
          content:
            application/json:
              schema:
                type: object
                properties:
                  claims:
                    type: array
                    items:
                      $ref: '#/components/schemas/ClaimEntity'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
              examples:
                example:
                  value:
                    claims:
                      - uid: 4f1a2b3c-5d6e-7f8a-9b0c-1d2e3f4a5b6c
                        automaticPayment: true
                        creationDate: '2025-09-05T10:00:00.000Z'
                        creditPrincipalOutstanding: 10000
                        status: 1
                        type: 0
                        amountToPay: 25000
                      - uid: 7e6d5c4b-3a2f-1e0d-9c8b-7a6f5e4d3c2b
                        automaticPayment: false
                        creationDate: '2025-09-06T10:00:00.000Z'
                        creditPrincipalOutstanding: 0
                        status: 2
                        type: 0
                        amountToPay: 18000
                    pagination:
                      startCursor: 4f1a2b3c-5d6e-7f8a-9b0c-1d2e3f4a5b6c
                      endCursor: 7e6d5c4b-3a2f-1e0d-9c8b-7a6f5e4d3c2b
                      hasNextPage: true
                      hasPreviousPage: false
                      totalCount: 27
        '400':
          description: Validation error
          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
      security:
        - apiKeyAuth: []
components:
  schemas:
    ClaimEntity:
      type: object
      description: Claim entity with exposed fields
      properties:
        uid:
          type: string
          description: Unique identifier of the claim
        automaticPayment:
          type: boolean
          description: Indicates if the claim is eligible for automatic payment
        creationDate:
          type: string
          format: date-time
          description: Claim creation date
        creditPrincipalOutstanding:
          type: number
          description: >-
            Outstanding principal amount of the credit as of the borrower’s last
            payment date.
        status:
          type: integer
          enum:
            - 0
            - 1
            - 2
            - 3
            - 4
          description: >-
            0=PENDING_REVIEW, 1=APPROVED, 2=PROCESSING_PAYMENT, 3=PAID,
            4=REJECTED
        type:
          type: integer
          enum:
            - 0
          description: >-
            Claim type. The default value is 0 that means DEFAULT_CLAIM, other
            values will be added in the future.
        amountToPay:
          type: number
          description: Amount pending to be paid for this claim
    Pagination:
      type: object
      description: Cursor-like pagination structure returned alongside results.
      properties:
        startCursor:
          type: string
          nullable: true
          description: UID of the first item in the current page.
        endCursor:
          type: string
          nullable: true
          description: UID of the last item in the current page.
        hasNextPage:
          type: boolean
          description: Indicates if there is a next page available.
        hasPreviousPage:
          type: boolean
          description: Indicates if there is a previous page available.
        totalCount:
          type: integer
          description: Total number of items matching the query.
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````