# Financing

Fetch active financing deals. Unlike other data endpoints, this returns an HTML page — deal data is embedded in `data-*` attributes on card elements.

---

## Endpoint

```
GET https://faisamobilex-wv.mib.com.mv/financing?dashurl=1
```

---

## Authentication

See [README](README.md) for cookie format.

### Additional Header

| Header | Value |
|---|---|
| `X-Requested-With` | `mv.com.mib.faisamobilex` |

Note: this endpoint uses the app package name as `X-Requested-With`, not `XMLHttpRequest`.

---

## Response

**Content-Type:** `text/html; charset=UTF-8`

Each financing deal is a `<div>` with class `finance-card-holder` and all fields as `data-*` attributes:

```html
<div class="card border finance-card-holder"
    data-productDesc       = "Product Name"
    data-dealStatus        = "P"
    data-statusDesc        = "Approved"
    data-dealAmount        = "10000.00"
    data-dealNo            = "12345"
    data-paidAmount        = "2500.00"
    data-outstandingAmount = "7500.00"
    data-dealDate          = "2024-01-15 00:00:00"
    data-overdueAmount     = "0"
    data-installmentAmount = "500.00"
    data-noOfInstallments  = "24"
    data-lastPaidDate      = "2026-05-01 00:00:00"
    data-lastPayAmount     = "500.00"
    data-financeCurrency   = "462"
    data-curCodeDesc       = "MVR">
```

### Data Fields

| Attribute | Type | Description |
|---|---|---|
| `productDesc` | String | Product name (e.g. `"Ujalaa CG Finance"`) |
| `dealStatus` | String | Status code (`P` = Active/Pending) |
| `statusDesc` | String | Human-readable status (e.g. `"Approved"`) |
| `dealAmount` | Decimal | Total financing amount |
| `dealNo` | Integer | Unique deal/contract number |
| `paidAmount` | Decimal | Amount paid to date |
| `outstandingAmount` | Decimal | Remaining unpaid balance |
| `dealDate` | String | Contract start date (`yyyy-MM-dd HH:mm:ss`) |
| `overdueAmount` | Decimal | Amount currently overdue (`0` if none) |
| `installmentAmount` | Decimal | Monthly installment amount |
| `noOfInstallments` | Integer | Total number of installments |
| `lastPaidDate` | String | Date of most recent payment (`yyyy-MM-dd HH:mm:ss`) |
| `lastPayAmount` | Decimal | Amount of most recent payment |
| `financeCurrency` | Integer | Currency numeric code (`462` = MVR) |
| `curCodeDesc` | String | Currency abbreviation (e.g. `"MVR"`) |

### Parsing

```kotlin
val cardPattern = Regex("""finance-card-holder[^>]+>""")
val attrPattern = Regex("""data-(\w+)\s*=\s*"([^"]*)"""")
```

Find all `finance-card-holder` elements, then extract `data-*` key/value pairs from each match.

---

## Completion Date Estimation

```
remainingInstallments = ceil(outstandingAmount / installmentAmount)
completionDate = today + remainingInstallments months
```

---

## Notes

- No encryption — session maintained purely via cookies.
- The response is gzip/brotli compressed; OkHttp handles decompression automatically.
- `time-tracker=597` appears static — omitting it may affect behavior.

---

&nbsp;

---

[← Cards](05-cards.md) &nbsp;&nbsp;&nbsp; **Next →** [Personal Profile](07-profile.md)