---
updatedAt: 2026-07-07T11:08:04.000Z
agentTools:
  projectIndex: https://docs.youlend.com/llms.txt
---

# List loans with filtering applied.

> 🚧 FAQ
>
> This endpoint does not cap results. However we recommend using date filters appropriate for your portfolio size such that <500 results are returned.
>
> You can filter on status, which will be one of: "Defaulted", "Discounted Settlement", "Funded", "Funded (Pending Settlement)", "Partially Funded", "Repaid", "Requested Funding", "Unfunded", "Written Off"
>
> currentAmount is the balance outstanding.
>
> fundedAmount is the amount that the customer borrowed. Equivalent to youWillGet in the Onboarding API.
>
> originalAmount is the amount that the customer borrowed plus the fee YouLend charged. i.e. the total amount that the customer needs to repay. Equivalent to youWillRepay in the Onboarding API.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Third Party Loan API",
    "version": "v2.0"
  },
  "servers": [
    {
      "url": "https://partners.staging-youlendapi.com/loan"
    }
  ],
  "paths": {
    "/Loans/allLoans/filter": {
      "get": {
        "tags": [
          "Loans"
        ],
        "summary": "List loans with filtering applied.",
        "operationId": "GetAllLoansByLendingPartnerWithFilters",
        "parameters": [
          {
            "name": "api-version",
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Search Criteria model",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TimeFilterSearchCriteria"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Request processed successfully",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LoansModelExtended"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LoansModelExtended"
                  }
                }
              }
            }
          },
          "204": {
            "description": "No loans were found that match the input criteria for the lending partner"
          },
          "400": {
            "description": "The request is invalid or the search criteria is incomplete or invalid.",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized request! Please check your bearer token",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ProblemDetails": {
        "type": "object",
        "additionalProperties": {
          "type": "object",
          "additionalProperties": false
        }
      },
      "TimeFilterSearchCriteria": {
        "type": "object",
        "properties": {
          "loanState": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Gets or sets the list of loan status to filter by.",
            "nullable": true
          },
          "dateFrom": {
            "type": "string",
            "description": "Gets or sets DateFrom, the funding date in YYYY-MM-DD HH:mm:ss.",
            "format": "date-time",
            "nullable": true
          },
          "dateTo": {
            "type": "string",
            "description": "Gets or sets DateTo, the funding date in YYYY-MM-DD HH:mm:ss.",
            "format": "date-time",
            "nullable": true
          },
          "index": {
            "type": "integer",
            "description": "Gets or sets the pagination index (default: 0).",
            "format": "int32",
            "nullable": true
          },
          "count": {
            "type": "integer",
            "description": "Gets or sets the pagination count (default: 500).",
            "format": "int32",
            "nullable": true
          },
          "repaymentMethod": {
            "type": "string",
            "description": "Gets or sets the repayment method filter.",
            "nullable": true
          },
          "thirdPartyCustomerId": {
            "type": "string",
            "description": "Gets or sets the third-party customer id filter.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Model used to filter loans."
      },
      "LoansModelExtended": {
        "type": "object",
        "properties": {
          "owner": {
            "type": "string",
            "description": "Gets or sets the company that owns the loan",
            "nullable": true
          },
          "thirdPartyCustomerId": {
            "type": "string",
            "description": "Gets or sets the TPCI associated with the loan",
            "nullable": true
          },
          "additionalInfo": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Gets or sets additional info associated with the loan, this is in a key value pair format",
            "nullable": true
          },
          "leadId": {
            "type": "string",
            "description": "Gets or sets the lead id associated with the loan",
            "format": "uuid"
          },
          "countryISOCode": {
            "type": "string",
            "description": "Gets or sets the registered country iso code of the borrower.",
            "nullable": true
          },
          "email": {
            "type": "string",
            "description": "Gets or sets the registered email of the borrower.",
            "nullable": true
          },
          "repaymentMethod": {
            "type": "string",
            "description": "Gets or sets the loan's repayment method.",
            "nullable": true
          },
          "repaymentFrequency": {
            "type": "string",
            "description": "Gets or sets the loan's repayment frequency - can be null when repayment method not Direct Debit or VRP.",
            "nullable": true
          },
          "expectedRepayment": {
            "type": "number",
            "description": "Gets or sets the loan's expected repayment amount - return 0 when frequency null.",
            "format": "double"
          },
          "productType": {
            "type": "string",
            "description": "Gets or sets the Product Type associated with the loan.",
            "nullable": true
          },
          "id": {
            "type": "string",
            "description": "Gets or sets the loan's unique identifier",
            "format": "uuid"
          },
          "loanNumber": {
            "type": "integer",
            "description": "Gets or sets the Loan Number, an ordinal value indicating which of a customer's loans is here detailed",
            "format": "int32"
          },
          "borrowerName": {
            "type": "string",
            "description": "Gets or sets the borrower's name",
            "nullable": true
          },
          "currentAmount": {
            "type": "number",
            "description": "Gets or sets the Current Amount, the amount yet to be repaid",
            "format": "double"
          },
          "loanType": {
            "type": "string",
            "description": "Gets or sets the Loan Type - \"Initial\", \"Early Renewal\" or \"Renewal\"",
            "nullable": true
          },
          "partnerLoanType": {
            "type": "string",
            "description": "Gets or sets the Partner Loan Type - \"Initial\", \"Early Renewal\" or \"Renewal\".",
            "nullable": true
          },
          "status": {
            "type": "string",
            "description": "Gets or sets the loan's Status - \"Defaulted\", \"Discounted Settlement\", \"Funded\", \"Funded (Pending Settlement)\", \"Partially Funded\", \"Repaid\", \"Requested Funding\", \"Unfunded\", \"Written Off\"",
            "nullable": true
          },
          "maturityDate": {
            "type": "string",
            "description": "Gets or sets the date on which the loan is due to mature, and by which it should be fully repaid",
            "format": "date-time"
          },
          "sweep": {
            "type": "number",
            "description": "Gets or sets the Sweep, the decimal out of 100 representing the proportion of transaction income to be used to repay the loan",
            "format": "double"
          },
          "autoRepaymentSweep": {
            "type": "boolean",
            "description": "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": {
            "type": "string",
            "description": "Gets or sets the loan's Currency ISO Code, e.g. \"GBP\"",
            "nullable": true
          },
          "currentAmountAtRepay": {
            "type": "number",
            "description": "Gets or sets the Current Amount at the time of full loan repayment, if applicable",
            "format": "double"
          },
          "currentAmountAtDelete": {
            "type": "number",
            "description": "Gets or sets the Current Amount at the time of loan deletion, if applicable",
            "format": "double"
          },
          "currentAmountAtWriteOff": {
            "type": "number",
            "description": "Gets or sets the Current Amount at the time of loan write-off, if applicable",
            "format": "double"
          },
          "merchantIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Gets or sets the associated MIDs",
            "nullable": true
          },
          "creditRating": {
            "type": "string",
            "description": "Gets or sets the Credit Rating",
            "nullable": true
          },
          "fundingDate": {
            "type": "string",
            "description": "Gets or sets the funding date",
            "format": "date-time"
          },
          "fundedAmount": {
            "type": "number",
            "description": "Gets or sets the funding amount",
            "format": "double"
          },
          "originalAmount": {
            "type": "number",
            "description": "Gets or sets the Original Amount, the total amount due to be repaid on maturity",
            "format": "double"
          },
          "aheadBehindValue": {
            "type": "number",
            "description": "Gets or sets how far ahead/behind the loan repayments are from the expected amount",
            "format": "double"
          },
          "aheadBehindPercentage": {
            "type": "number",
            "description": "Gets or sets how far ahead/behind the actual average payments are from the average expected payments as a percentage",
            "format": "double"
          },
          "contractType": {
            "type": "string",
            "description": "Gets or sets the agreement contract type (\"RPA\" / \"LA\") if available.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Model representing one of a selection of loans, with time and possible loan status filtering"
      }
    },
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://youlend-stag.eu.auth0.com/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "oauth2": []
    }
  ]
}
```