---
title: "List loans with filtering applied."
method: GET
path: "/Loans/allLoans/filter"
tags: ["Loans"]
---

# List loans with filtering applied.

`GET /Loans/allLoans/filter`

## Headers

- `api-version` string

## Request body

- TimeFilterSearchCriteria — Model used to filter loans.
  - `loanState` string[], nullable — Gets or sets the list of loan status to filter by.
  - `dateFrom` string, date-time, nullable — Gets or sets DateFrom, the funding date in YYYY-MM-DD HH:mm:ss.
  - `dateTo` string, date-time, nullable — Gets or sets DateTo, the funding date in YYYY-MM-DD HH:mm:ss.
  - `index` integer, nullable — Gets or sets the pagination index (default: 0).
  - `count` integer, nullable — Gets or sets the pagination count (default: 500).
  - `repaymentMethod` string, nullable — Gets or sets the repayment method filter.
  - `thirdPartyCustomerId` string, nullable — Gets or sets the third-party customer id filter.

## Response `200`

Request processed successfully

- LoansModelExtended[]
  - `owner` string, nullable — Gets or sets the company that owns the loan
  - `thirdPartyCustomerId` string, nullable — Gets or sets the TPCI associated with the loan
  - `additionalInfo` object, nullable — Gets or sets additional info associated with the loan, this is in a key value pair format
  - `leadId` string, uuid — Gets or sets the lead id associated with the loan
  - `countryISOCode` string, nullable — Gets or sets the registered country iso code of the borrower.
  - `email` string, nullable — Gets or sets the registered email of the borrower.
  - `repaymentMethod` string, nullable — Gets or sets the loan's repayment method.
  - `repaymentFrequency` string, nullable — Gets or sets the loan's repayment frequency - can be null when repayment method not Direct Debit or VRP.
  - `expectedRepayment` number, double — Gets or sets the loan's expected repayment amount - return 0 when frequency null.
  - `productType` string, nullable — Gets or sets the Product Type associated with the loan.
  - `id` string, uuid — Gets or sets the loan's unique identifier
  - `loanNumber` integer — Gets or sets the Loan Number, an ordinal value indicating which of a customer's loans is here detailed
  - `borrowerName` string, nullable — Gets or sets the borrower's name
  - `currentAmount` number, double — Gets or sets the Current Amount, the amount yet to be repaid
  - `loanType` string, nullable — Gets or sets the Loan Type - "Initial", "Early Renewal" or "Renewal"
  - `partnerLoanType` string, nullable — Gets or sets the Partner Loan Type - "Initial", "Early Renewal" or "Renewal".
  - `status` string, nullable — Gets or sets the loan's Status - "Defaulted", "Discounted Settlement", "Funded", "Funded (Pending Settlement)", "Partially Funded", "Repaid", "Requested Funding", "Unfunded", "Written Off"
  - `maturityDate` string, date-time — Gets or sets the date on which the loan is due to mature, and by which it should be fully repaid
  - `sweep` number, double — Gets or sets the Sweep, the decimal out of 100 representing the proportion of transaction income to be used to repay the loan
  - `autoRepaymentSweep` boolean — Gets or sets a value indicating whether an Auto Repayment Sweep is to be used - this feature automatically directs a chosen proportion, the Sweep, of transaction income towards repaying the loan
  - `currencyISOCode` string, nullable — Gets or sets the loan's Currency ISO Code, e.g. "GBP"
  - `currentAmountAtRepay` number, double — Gets or sets the Current Amount at the time of full loan repayment, if applicable
  - `currentAmountAtDelete` number, double — Gets or sets the Current Amount at the time of loan deletion, if applicable
  - `currentAmountAtWriteOff` number, double — Gets or sets the Current Amount at the time of loan write-off, if applicable
  - `merchantIds` string[], nullable — Gets or sets the associated MIDs
  - `creditRating` string, nullable — Gets or sets the Credit Rating
  - `fundingDate` string, date-time — Gets or sets the funding date
  - `fundedAmount` number, double — Gets or sets the funding amount
  - `originalAmount` number, double — Gets or sets the Original Amount, the total amount due to be repaid on maturity
  - `aheadBehindValue` number, double — Gets or sets how far ahead/behind the loan repayments are from the expected amount
  - `aheadBehindPercentage` number, double — Gets or sets how far ahead/behind the actual average payments are from the average expected payments as a percentage
  - `contractType` string, nullable — Gets or sets the agreement contract type ("RPA" / "LA") if available.

## Other responses

- `204` — No loans were found that match the input criteria for the lending partner
- `400` — The request is invalid or the search criteria is incomplete or invalid.
- `401` — Unauthorized request! Please check your bearer token

---

[API](https://skmtc.dev/youlend/apis/prequalification.md) · [All operations](https://skmtc.dev/youlend/apis/prequalification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/youlend/prequalification/revisions/a76313c6cc3d/schema)
