---
updatedAt: 2026-05-29T13:25:42.000Z
agentTools:
  projectIndex: https://developer.eftcorp.com/llms.txt
---

# Get all loan associated with the customer

Get all loan associated with the customer

# OpenAPI definition

```json
{
  "servers": [
    {
      "url": "https://eclipse-java-sandbox.ukheshe.rocks",
      "description": "Eclipse sandbox environment"
    },
    {
      "url": "https://ukheshe.live",
      "description": "Eclipse production environment"
    },
    {
      "url": "https://eclipse-java-develop.ukheshe.rocks",
      "description": "Eclipse development environment"
    },
    {
      "url": "https://zw.ukheshe.live",
      "description": "Zim Eclipse production environment"
    }
  ],
  "openapi": "3.1.0",
  "components": {
    "schemas": {
      "EclipseLoanStatus": {
        "description": "Status of a Loan: BUILDING: The loan application has been received but not yet reviewed, PENDING: The loan application is under review, APPROVED: The loan application has been approved, ACTIVE: The loan amount has been disbursed to the borrower, DEFAULT: The borrower has failed to make payments for an extended period, and the loan is in default status. UNAPPROVED: The loan application has been unapproved, PAID_OFF: The loan has been fully paid off by the customer, CANCELLED: The customer has canceled the loan application before it was approved or funded. ERROR_PERM: Loan application is not successful",
        "type": "string",
        "enum": [
          "ACTIVE",
          "APPROVED",
          "BUILDING",
          "CANCELLED",
          "ERROR_PERM",
          "PAID_OFF",
          "PENDING",
          "UNAPPROVED"
        ]
      },
      "LoanAdditionalField": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "LoanResult": {
        "type": "object",
        "properties": {
          "additionalFields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LoanAdditionalField"
            },
            "description": "Fields that must be completed by the borrower and provided on the POST or PUT to update the loan for processing. Its up to the UI to decide how to lay these out and ask for them as the loans API will require these fields"
          },
          "amount": {
            "type": "number",
            "description": "Representing the loan amount requested by the customer",
            "exclusiveMinimum": 0
          },
          "callbackUrl": {
            "type": "string",
            "description": "The URL Eclipse must post the LoanResult to when the loan is either approved or un approved. Optional as one can always do a GET to get the result instead of using callbacks. This will be a system-system call",
            "pattern": "^http(s)?:\\/\\/.*\\..*$",
            "minLength": 10,
            "maxLength": 2000
          },
          "created": {
            "type": "string",
            "format": "date-time",
            "examples": [
              "2022-03-10T12:15:50-04:00"
            ],
            "description": "When the loan was posted"
          },
          "currency": {
            "type": "string",
            "description": "The currency of the wallet - e.g. USD, ZAR, NGN, TSH",
            "minLength": 3,
            "maxLength": 3
          },
          "currentBalance": {
            "type": "number",
            "description": "This refers to the total amount that is currently owed on a loan, including any unpaid principal, interest. It is the amount that the borrower would have to pay in full to pay off the loan at the present time"
          },
          "customerId": {
            "type": "integer",
            "format": "int64"
          },
          "description": {
            "type": "string",
            "description": "Loan Description",
            "pattern": "(?s)^(?:[\\t\\r\\n]|[^\\p{C}<>])*$",
            "minLength": 0,
            "maxLength": 200
          },
          "errorDescription": {
            "type": "string",
            "description": "Loan Error Description"
          },
          "externalUniqueId": {
            "type": "string",
            "description": "A globally unique identifier"
          },
          "fee": {
            "type": "number",
            "description": "The fees applicable on choosen loan provider and loan product"
          },
          "interestRate": {
            "type": "number",
            "description": "Representing the interest rate based on choosen loan provider and product"
          },
          "lastModified": {
            "type": "string",
            "format": "date-time",
            "examples": [
              "2022-03-10T12:15:50-04:00"
            ],
            "description": "When the loan was last modified"
          },
          "loanId": {
            "type": "integer",
            "format": "int64",
            "description": "A unique system generated numeric identifier for the loan",
            "exclusiveMinimum": 0
          },
          "maxLoanAmount": {
            "type": "number",
            "description": "The maximum amount that can be loaned with this to this customer"
          },
          "minLoanAmount": {
            "type": "number",
            "description": "The minimum amount that can be loaned with this to this customer"
          },
          "provider": {
            "type": "string",
            "description": "Loan provider"
          },
          "status": {
            "$ref": "#/components/schemas/EclipseLoanStatus",
            "description": "The status of loan",
            "type": "string"
          },
          "walletId": {
            "type": "integer",
            "format": "int64",
            "description": "A walletId representing the id of the customer's wallet where the loan amount will be credited or debited when making payments on the loan",
            "exclusiveMinimum": 0
          }
        },
        "required": [
          "currency"
        ]
      }
    },
    "securitySchemes": {
      "JWTBearerAuthorisation": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "info": {
    "description": "A RESTful API using JSON as the data transfer model, covering all tenant-facing functionality in the Eclipse payments platform.",
    "title": "Eclipse ReST API",
    "version": "3.0.0"
  },
  "tags": [
    {
      "name": "d) Customer Management",
      "description": "Operations on an individual customer profile including identity management, addresses, documents, wallets, cards, beneficiaries, and KYC ratification."
    }
  ],
  "paths": {
    "/eclipse-conductor/rest/v1/tenants/{tenantId}/customers/{customerId}/loans": {
      "get": {
        "summary": "Get all loan associated with the customer",
        "description": "Get all loan associated with the customer",
        "tags": [
          "d) Customer Management"
        ],
        "parameters": [
          {
            "name": "tenantId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "description": "dateFromIncl, the date from where we want to get the loans inclusive.",
            "required": false,
            "name": "dateFromIncl",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "dateToExcl, the date upto when we want to get the loans exclusive.",
            "required": false,
            "name": "dateToExcl",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "description": "The provider filter is applied, the results will be limited to the specified loan provider.",
            "required": true,
            "name": "provider",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "DUMMY"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoanResult"
                }
              }
            }
          }
        },
        "security": [
          {
            "JWTBearerAuthorisation": []
          }
        ]
      }
    }
  }
}
```