---
updatedAt: 2026-08-27T13:52:09.000Z
agentTools:
  projectIndex: https://docs.youlend.com/llms.txt
---

# List loan offers.

This endpoint returns offers for a lead. In the case of an instant offer this returns three offers, but for non instant offers this number can vary.

Typically, the offers provided have different sweep amounts. N.B. this does not return flexible offers - flexible offers are provided only by the `200` response from the request to calculate them.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Onboarding",
    "description": "Through this API you can can initiate the process of onboarding a borrower with YouLend",
    "contact": {
      "name": "Mark Ufland",
      "email": "mark.ufland@youlend.com"
    },
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://partners.staging-youlendapi.com/onboarding"
    }
  ],
  "paths": {
    "/Leads/{leadId}/offers": {
      "get": {
        "tags": [
          "Offers and Signing"
        ],
        "summary": "List loan offers.",
        "parameters": [
          {
            "name": "leadId",
            "in": "path",
            "description": "The lead id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "api-version",
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OfferStepModel"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/OfferStepModel"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Document": {
        "type": "object",
        "properties": {
          "documentId": {
            "type": "string",
            "description": "Gets or sets the document id, a GUID.",
            "format": "uuid"
          },
          "documentName": {
            "type": "string",
            "description": "Gets or sets the document name.",
            "nullable": true
          },
          "documentType": {
            "type": "string",
            "description": "Gets or sets the document type.",
            "nullable": true
          },
          "dateTimeUploaded": {
            "type": "string",
            "description": "Gets or sets the DateTime of the document upload.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Model containing the metadata for a document."
      },
      "LoanOfferDetails": {
        "type": "object",
        "properties": {
          "offerId": {
            "type": "string",
            "format": "uuid"
          },
          "youWillGet": {
            "type": "number",
            "format": "double"
          },
          "youWillRepay": {
            "type": "number",
            "format": "double"
          },
          "currencyISOCode": {
            "type": "string",
            "nullable": true
          },
          "sweep": {
            "type": "number",
            "format": "double"
          },
          "minimumWeeklyRepayment": {
            "type": "number",
            "format": "double"
          },
          "daysUntilRepayment": {
            "type": "integer",
            "format": "int32"
          },
          "maturityDate": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OfferStepModel": {
        "type": "object",
        "properties": {
          "leadId": {
            "type": "string",
            "description": "Gets or sets the lead id.",
            "format": "uuid"
          },
          "previousAcceptedOffer": {
            "$ref": "#/components/schemas/LoanOfferDetails"
          },
          "providedOffers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LoanOfferDetails"
            },
            "description": "Gets or sets the list of provided offers.",
            "nullable": true
          },
          "acceptedOffer": {
            "$ref": "#/components/schemas/LoanOfferDetails"
          },
          "unsignedLoanDocument": {
            "$ref": "#/components/schemas/Document"
          },
          "unsignedLoanDocumentDownloaded": {
            "type": "boolean",
            "description": "Gets or sets a value indicating whether the unsigned loan document has been downloaded."
          },
          "documentSigningId": {
            "type": "string",
            "description": "Gets or sets the document signing id.",
            "format": "uuid"
          },
          "sortCode": {
            "type": "string",
            "description": "Gets or sets the sort code of the lead's account.",
            "nullable": true
          },
          "accountNumber": {
            "type": "string",
            "description": "Gets or sets the account number for the lead.",
            "nullable": true
          },
          "swift": {
            "type": "string",
            "description": "Gets or sets the swift code for the lead's account.",
            "nullable": true
          },
          "iban": {
            "type": "string",
            "description": "Gets or sets the IBAN for the lead's account.",
            "nullable": true
          },
          "bankName": {
            "type": "string",
            "description": "Gets or sets the name of the bank associated with the lead's account.",
            "nullable": true
          },
          "confirmedCompanyAccount": {
            "type": "boolean",
            "description": "Gets or sets a value indicating whether the account is confirmed to be the company account."
          },
          "minFundingAmount": {
            "type": "number",
            "format": "double"
          },
          "maxFundingAmount": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false,
        "description": "Model containing details about an offer."
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": {}
      }
    },
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://youlend-stag.eu.auth0.com/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "oauth2": []
    }
  ],
  "tags": [
    {
      "name": "Offers and Signing"
    }
  ]
}
```