Files
thijooree/docs/mibapi/06-financing.md
Shihaam Abdul Rahman 256f216da4
All checks were successful
Auto Tag on Version Change / check-version (push) Successful in 4s
update docs
2026-05-23 23:46:00 +05:00

3.0 KiB

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 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:

<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

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.

 


← Cards     Next → Personal Profile