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

# Listar préstamos morosos

> Devuelve filas de desglose de préstamos morosos para una cartera y un bucket en una fecha de negocio solicitada.



## OpenAPI

````yaml es/openapi/v3-current/lender.yaml get /api/v1/dashboard/delinquent-loans
openapi: 3.1.0
info:
  contact:
    email: contact@lerian.studio
    name: Lerian Studio
    url: https://lerian.studio
  description: Superficie OpenAPI 3.1 code-first del servicio Lender.
  license:
    name: Lerian Studio General License
  title: Lender API
  version: 1.0.0
servers:
  - url: https://lender.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - description: >-
      Operaciones de contabilidad del ledger: entradas de journal y asientos de
      accrual para cuentas de préstamo.
    name: Accounting
  - description: >-
      Recepción y ciclo de vida de la solicitud de préstamo: envío, decisión y
      estado.
    name: LoanApplications
  - description: >-
      Catálogo de productos de préstamo: definición, versionado y activación de
      productos de crédito.
    name: LoanProducts
  - description: >-
      Operaciones de servicing de cuentas de préstamo: saldos, cronogramas y
      acciones a nivel de cuenta.
    name: Loan Accounts
  - description: >-
      Operaciones de lectura de servicing: cronogramas de reembolso y estado de
      servicing para cuentas de préstamo.
    name: Servicings
  - description: >-
      Operaciones de lectura del panel de cartera: vistas agregadas de cartera y
      de rendimiento.
    name: Dashboard
  - description: >-
      Registro de jurisdicciones: perfiles de jurisdicción soportados y sus
      capacidades.
    name: Jurisdictions
  - description: >-
      Operaciones de solicitud de préstamo específicas por jurisdicción
      (superficie de originación de Brasil).
    name: Loan Applications
  - description: >-
      Operaciones de cálculo de impuestos para crédito específico por
      jurisdicción (por ejemplo, IOF de Brasil).
    name: Tax
  - description: >-
      Operaciones de consignado privado de Brasil: originación de contrato
      (contratación activa) y ciclo de vida.
    name: Consignado
paths:
  /api/v1/dashboard/delinquent-loans:
    get:
      tags:
        - Dashboard
      summary: Listar préstamos morosos
      description: >-
        Devuelve filas de desglose de préstamos morosos para una cartera y un
        bucket en una fecha de negocio solicitada.
      operationId: listDelinquentLoans
      parameters:
        - description: Portfolio identifier.
          explode: false
          in: query
          name: portfolioId
          required: true
          schema:
            description: Portfolio identifier.
            examples:
              - 550e8400-e29b-41d4-a716-446655440000
            format: uuid
            type: string
        - description: Business date (YYYY-MM-DD); defaults to today (UTC).
          explode: false
          in: query
          name: asOf
          schema:
            description: Business date (YYYY-MM-DD); defaults to today (UTC).
            examples:
              - '2026-06-14'
            format: date
            type: string
        - description: Filter by loan product identifiers (repeat to pass multiple).
          explode: true
          in: query
          name: productIds
          schema:
            description: Filter by loan product identifiers (repeat to pass multiple).
            examples:
              - - 550e8400-e29b-41d4-a716-446655440001
            items:
              format: uuid
              type: string
            maxItems: 100
            type:
              - array
              - 'null'
        - description: >-
            Filter by loan product version identifiers (repeat to pass
            multiple).
          explode: true
          in: query
          name: productVersionIds
          schema:
            description: >-
              Filter by loan product version identifiers (repeat to pass
              multiple).
            examples:
              - - 550e8400-e29b-41d4-a716-446655440002
            items:
              format: uuid
              type: string
            maxItems: 100
            type:
              - array
              - 'null'
        - description: Delinquency bucket code.
          explode: false
          in: query
          name: bucketCode
          schema:
            description: Delinquency bucket code.
            enum:
              - current
              - '1_30'
              - '31_60'
              - '61_90'
              - 91_plus
              - par30
              - par60
              - par90
            examples:
              - par30
            type: string
        - description: Filter by assigned officer identifier.
          explode: false
          in: query
          name: assignedOfficerId
          schema:
            description: Filter by assigned officer identifier.
            examples:
              - 550e8400-e29b-41d4-a716-446655440003
            format: uuid
            type: string
        - description: Page size.
          explode: false
          in: query
          name: limit
          schema:
            default: 25
            description: Page size.
            examples:
              - 25
            format: int64
            maximum: 100
            minimum: 1
            type: integer
        - description: Page offset.
          explode: false
          in: query
          name: offset
          schema:
            default: 0
            description: Page offset.
            examples:
              - 0
            format: int64
            maximum: 10000
            minimum: 0
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DelinquentLoansHumaBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Detail'
          description: Error
components:
  schemas:
    DelinquentLoansHumaBody:
      additionalProperties: false
      properties:
        asOfDate:
          description: Business date the rows were computed for (RFC3339, UTC midnight).
          examples:
            - '2026-06-14T12:00:00Z'
          format: date-time
          type: string
        freshness:
          $ref: '#/components/schemas/DashboardFreshnessHuma'
          description: >-
            Provenance of the rows: snapshot identity, staleness, and freshness
            policy.
        limit:
          description: Page size echoed back from the request (max rows in this response).
          examples:
            - 25
          format: int64
          type: integer
        loans:
          description: >-
            Delinquent loan drill-down rows for the page; always a JSON array
            (never null).
          items:
            $ref: '#/components/schemas/DelinquentLoanRowHuma'
          type:
            - array
            - 'null'
        offset:
          description: Zero-based row offset echoed back from the request.
          examples:
            - 0
          format: int64
          type: integer
      required:
        - loans
        - freshness
        - asOfDate
        - limit
        - offset
      type: object
    Detail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable domain error code scoped to the emitting
            service (format: <SERVICE>-NNNN).
          examples:
            - ERR-0001
          type: string
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    DashboardFreshnessHuma:
      additionalProperties: false
      properties:
        generatedAt:
          description: Timestamp when the snapshot was generated (RFC3339, UTC).
          examples:
            - '2026-06-14T12:00:00Z'
          format: date-time
          type: string
        isStale:
          description: True when the snapshot is older than the freshness policy allows.
          type: boolean
        liveFallbackUsed:
          description: >-
            True when no usable snapshot existed and metrics were computed live
            as a fallback.
          type: boolean
        policyCode:
          description: Code of the freshness policy applied to evaluate staleness.
          type: string
        policyPersistedAt:
          description: >-
            Timestamp when the active freshness policy was last persisted
            (RFC3339, UTC).
          examples:
            - '2026-06-14T12:00:00Z'
          format: date-time
          type: string
        snapshotAsOfDate:
          description: Business date the source snapshot was computed for (RFC3339, UTC).
          examples:
            - '2026-06-14T12:00:00Z'
          format: date-time
          type: string
        snapshotId:
          description: >-
            Identifier (UUID) of the snapshot the metrics were read from; empty
            when served live.
          examples:
            - 550e8400-e29b-41d4-a716-446655440020
          type: string
        source:
          description: Origin of the metrics (e.g. snapshot vs. live computation).
          type: string
        stalenessReason:
          description: Explanation of why the data is considered stale; omitted when fresh.
          type: string
      required:
        - snapshotId
        - snapshotAsOfDate
        - generatedAt
        - source
        - liveFallbackUsed
        - isStale
        - policyCode
        - policyPersistedAt
      type: object
    DelinquentLoanRowHuma:
      additionalProperties: false
      properties:
        asOfDate:
          description: Business date the row was computed for (RFC3339, UTC midnight).
          examples:
            - '2026-06-14T12:00:00Z'
          format: date-time
          type: string
        assignedOfficerId:
          description: Identifier (UUID) of the loan officer assigned to the loan.
          examples:
            - 550e8400-e29b-41d4-a716-446655440012
          type: string
        assignedOfficerName:
          description: Display name of the assigned loan officer.
          type: string
        borrowerId:
          description: Borrower identifier (UUID) who holds the loan.
          examples:
            - 550e8400-e29b-41d4-a716-446655440011
          type: string
        borrowerName:
          description: Display name of the borrower.
          type: string
        bucketCode:
          description: >-
            Delinquency bucket the loan falls into (one of current, 1_30, 31_60,
            61_90, 91_plus, par30, par60, par90).
          examples:
            - '31_60'
          type: string
        daysOverdue:
          description: >-
            Number of days past the oldest unpaid due date as of the business
            date.
          examples:
            - 45
          format: int64
          type: integer
        loanAccountId:
          description: Loan account identifier (UUID) for this delinquent loan.
          examples:
            - 550e8400-e29b-41d4-a716-446655440010
          type: string
        oldestDueDate:
          description: >-
            Due date of the oldest unpaid installment driving the delinquency
            (RFC3339, UTC).
          examples:
            - '2026-06-14T12:00:00Z'
          format: date-time
          type: string
        outstandingAmount:
          description: >-
            Total outstanding principal balance on the loan (decimal string,
            two-decimal scale).
          examples:
            - '12500.00'
          type: string
        overdueAmount:
          description: >-
            Total past-due amount on the loan (decimal string, two-decimal
            scale).
          examples:
            - '3200.00'
          type: string
        productId:
          description: Loan product identifier (UUID) the loan was originated under.
          examples:
            - 550e8400-e29b-41d4-a716-446655440013
          type: string
        productVersionId:
          description: Loan product version identifier (UUID) governing this loan's terms.
          examples:
            - 550e8400-e29b-41d4-a716-446655440014
          type: string
      required:
        - loanAccountId
        - borrowerId
        - borrowerName
        - assignedOfficerId
        - assignedOfficerName
        - productId
        - productVersionId
        - bucketCode
        - daysOverdue
        - overdueAmount
        - outstandingAmount
        - oldestDueDate
        - asOfDate
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````