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

# Get a loan

> Fetch a single loan by externalId or LMS id.

Two equivalent forms. **Prefer the externalId path** — it's a direct
LMS lookup (`/loans/external-id/{X}`), single call, and lets you key
off the reference you chose at create time.

## Path parameters

<ParamField path="loan_external_id" type="string" required>
  The loan's externalId. On the `/v1/loans/{loan_id}` form, this is
  the numeric LMS id instead.
</ParamField>

## Examples

```bash theme={null}
# By loan externalId (recommended)
curl -sf "$BASE/v1/loans/external/loan-ext-12345" \
  -H "Authorization: Bearer $TOKEN"

# By LMS id
curl -sf "$BASE/v1/loans/501" \
  -H "Authorization: Bearer $TOKEN"
```

## Response

`200 OK` returns the full [loan object](/loans/overview) — including
the balance roll-up, `nextDueDate` / `nextDueAmount`, and the full
`repaymentSchedule`.

## Errors

| Code        | When                               |
| ----------- | ---------------------------------- |
| `not_found` | No loan with that id or externalId |