> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Loan

> Retrieve a loan with its current LTV, outstanding balance, and repayment schedule.

### Overview

Returns the loan and, critically, its **current** collateral position. Collateral is marked to
market, so `ltv_ratio` moves without you doing anything — this endpoint is how you find out before a
margin call does.

### Path

<ParamField path="id" type="string" required>
  The loan identifier, e.g. `loan_5z8nPq3oW7`.
</ParamField>

### Response

<ResponseField name="loan_id" type="string" required>
  Loan identifier.
</ResponseField>

<ResponseField name="status" type="string" required>
  `PENDING_APPROVAL`, `APPROVED`, `ACTIVE`, `REPAID`, or `LIQUIDATED`.
</ResponseField>

<ResponseField name="approved_amount" type="string" required>
  Principal approved.
</ResponseField>

<ResponseField name="drawn_amount" type="string" required>
  Principal actually drawn. Approved but undrawn principal accrues no interest.
</ResponseField>

<ResponseField name="outstanding_balance" type="string" required>
  Principal plus accrued interest still owed.
</ResponseField>

<ResponseField name="interest_rate" type="number" required>
  Annual rate as a decimal.
</ResponseField>

<ResponseField name="term_months" type="number" required>
  Loan term.
</ResponseField>

<ResponseField name="total_collateral_value" type="string" required>
  Current mark-to-market value of posted collateral.
</ResponseField>

<ResponseField name="ltv_ratio" type="number" required>
  Current loan-to-value — outstanding ÷ collateral value. **Monitor this.** It rises when collateral
  falls in value as readily as when you draw more principal.
</ResponseField>

<ResponseField name="liquidation_threshold" type="number" required>
  The LTV at which collateral is liquidated. The gap between this and `ltv_ratio` is your headroom.
</ResponseField>

<ResponseField name="next_payment" type="object" required>
  Due date and amount of the next scheduled payment.
</ResponseField>

<ResponseField name="repayment_schedule" type="array" required>
  Every scheduled payment, each split into principal and interest.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://api.stateset.com/v1/finance/loans/loan_5z8nPq3oW7' \
    -H 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "loan_id": "loan_5z8nPq3oW7",
    "status": "ACTIVE",
    "approved_amount": "25000.00",
    "drawn_amount": "25000.00",
    "outstanding_balance": "23076.83",
    "interest_rate": 0.075,
    "term_months": 12,
    "total_collateral_value": "61200.00",
    "ltv_ratio": 0.38,
    "liquidation_threshold": 0.75,
    "next_payment": { "due_date": "2024-08-25", "total": "2256.50" },
    "repayment_schedule": [
      {
        "payment_number": 1,
        "due_date": "2024-07-25",
        "principal": "1923.17",
        "interest": "333.33",
        "total": "2256.50",
        "status": "PAID"
      }
    ]
  }
  ```
</ResponseExample>

<Warning>
  Do not infer safety from a low `ltv_ratio` at one point in time. If your collateral is volatile,
  poll this endpoint or subscribe to the corresponding
  [webhook](/stateset-commerce-api-reference/webhooks) — liquidation is automatic and does not wait
  for a missed payment.
</Warning>

### Related

* [List Loans](/stateset-commerce-api-reference/loans/list)
* [Repay Loan](/stateset-commerce-api-reference/loans/repay)
* [Liquidate Loan](/stateset-commerce-api-reference/loans/liquidate)