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

# List all loans

We recommend that [List loans with filtering applied.](https://docs.youlend.com/reference/getallloansbylendingpartnerwithfilters) is used instead of this endpoint because it returns richer data, and has (optional) filtering.

# 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": {
      "get": {
        "tags": [
          "Loans"
        ],
        "summary": "List all loans",
        "operationId": "GetAllLoans",
        "parameters": [
          {
            "name": "api-version",
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Request processed successfully",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LoansModel"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LoansModel"
                  }
                }
              },
              "application/xml": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LoansModel"
                  }
                }
              },
              "text/xml": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LoansModel"
                  }
                }
              }
            }
          },
          "400": {
            "description": "No loans were found",
            "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
        }
      },
      "LoansModel": {
        "type": "object",
        "properties": {
          "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"
      }
    },
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://youlend-stag.eu.auth0.com/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "oauth2": []
    }
  ]
}
```