---
title: "(Fast Track only) Retrieve a loan by lead id"
method: GET
path: "/Loans/{fastTrackLeadId}/loanByFastTrack"
tags: ["Loans"]
---

# (Fast Track only) Retrieve a loan by lead id

`GET /Loans/{fastTrackLeadId}/loanByFastTrack`

## Request

- Base URL: `https://partners.staging-youlendapi.com/loan`
- URL: `https://partners.staging-youlendapi.com/loan/Loans/{fastTrackLeadId}/loanByFastTrack`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://youlend-stag.eu.auth0.com/oauth/token`

## Path parameters

- `fastTrackLeadId` string, uuid, required: Fast Track Lead ID (a GUID)

## Headers

- `api-version` string

## Response `200`

Request processed successfully

- LoanModel: A model representing the details of an individual 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.
  - `borrowerId` string, uuid: Gets or sets the Borrower ID.
  - `borrowerName` string, nullable: Gets or sets the Borrower Name.
  - `currencyISOCode` string, nullable: Gets or sets the Currency ISO Code.
  - `currentAmount` number, double: Gets or sets the Current Amount, the amount yet to be repaid.
  - `currentServiceChargeRate` number, double: (DEPRECATED).
  - `defaultDetails` DefaultDetailsModel: A model representing an instance of loan default, the failure to repay debt associated with a given loan
    - `reason` string, nullable: Gets or sets the reason, put concisely, for the default
    - `reasonDetails` string, nullable: Gets or sets a more detailed account of the reason for default
    - `dateDefaulted` string, date-time: Gets or sets the date on which default occurred
    - `currentAmountAtTimeOfDefault` number, double: Gets or sets the loan's Current Amount at the time of default
  - `discount` number, double: Gets or sets the loan's discount rate.
  - `id` string, uuid: Gets or sets the loan's unique identifier.
  - `approvalDate` string, date-time: (DEPRECATED).
  - `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.
  - `originalAmount` number, double: Gets or sets the Original Amount, the total amount due to be repaid on maturity.
  - `originalServiceChargeRate` number, double: (DEPRECATED).
  - `projectedRepaymentDate` string, date-time: Gets or sets the Projected Repayment Date.
  - `securityAndGuarantees` boolean: (DEPRECATED).
  - `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".
  - `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.
  - `loanNumber` integer: Gets or sets the Loan Number, an ordinal value indicating which of a customer's loans is here detailed.
  - `creditRating` string, nullable: Gets or sets the Credit Rating.
  - `lead` LeadDetailsModel: A model detailing a given loan's lead details.
    - `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.
  - `earlyRenewalDetails` EarlyRenewalDetailsModel: A model detailing an instance of Early Renewal
    - `oldLoanId` string, uuid: Gets or sets the Loan ID of the loan which was renewed
    - `oldLoanNumber` integer: Gets or sets the Loan Number of the loan which was renewed
    - `isOldLoanRepaid` boolean: Gets or sets a value indicating whether the loan which was renewed has been fully repaid
    - `newLoanId` string, uuid: Gets or sets the Loan ID of the Early Remewal loan created
    - `newLoanNumber` integer: Gets or sets the Loan Number of the Early Remewal loan created
  - `fundingDetails` LoanFundingDetailsModel: A model detailing a given loan's funding
    - `fundingAmount` number, double: Gets or sets the Funding Amount, equal to the Amount Funded when the loan is fully funded
    - `fundingDate` string, date-time: Gets or sets the date on which the loan became fully funded
    - `fundingPayments` LoanFundingPaymentModel[], nullable: Gets or sets a collection of Funding Payments
      - `paymentDate` string, date-time: Gets or sets the Payment Date
      - `paymentAmount` number, double: Gets or sets the Payment Amount
    - `amountFunded` number, double: Gets or sets the Amount Funded
  - `writeOffDetails` LoanWriteOffDetailsModel: A model detailing the write-off of a given loan, if applicable
    - `paymentDate` string, date-time: Gets or sets the Payment Date
    - `paymentAmount` number, double: Gets or sets the Payment Amount
  - `thirdPartyReferences` ThirdPartyReferenceModel[], nullable: Gets or sets the loan's Third Party References YL.Web.Api.ThirdParty.Loan.V2.Models.ThirdPartyReferenceModel.
    - `thirdPartyId` string, uuid: Gets or sets the third party's unique identifier
    - `thirdPartyReference` string, nullable: Gets or sets the reference provided by the third party
  - `documents` YLAdvanceLoanDocument[], nullable: Gets or sets the all loan document metadata and document type YL.Web.Api.ThirdParty.Loan.V2.Models.YLAdvanceLoanDocument.
    - `document` DocumentMetadataModel: A model characterising a given document
      - `documentId` string, uuid: Gets or sets the document's unique identifier
      - `documentName` string, nullable: Gets or sets the Document Name
      - `documentType` string, nullable: Gets or sets the Document Type - "Loan Agreement" or "Transfer Agreement"
      - `dateUploaded` string, date-time: Gets or sets the date on which the document was uploaded
    - `documentType` string, nullable: Gets or sets the document type
  - `contractType` string, nullable: Gets or sets the agreement contract type ("RPA" / "LA") if available.

## Other responses

- `400`: No loans were found... please check your Fast Track Lead ID
- `401`: Unauthorized request! Please check your bearer token

---

[API](https://skmtc.dev/youlend/apis/third-party-loan-api.md) - [All operations](https://skmtc.dev/youlend/apis/third-party-loan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/youlend/apis/third-party-loan-api/revisions/2336031a2fcf?raw)
