android/docs/mibapi/04-history.md

Transaction History

Fetch paginated transaction history for a single MIB account. Served from the encrypted API.

The account must belong to the currently selected profile — call P47 for its profile first (see 03-accounts.md).

---

Transaction History — sfunc=n, routePath: A84

Key: session key

Request:

{
  "sfunc": "n",
  "xxid": "<session xxid>",
  "data": {
    "accountNo": "90101000000001000",
    "start": 0,
    "end": 19,
    "includeCount": true,
    "trxType": 0,
    "sortTrx": "date",
    "sortDir": "desc",
    "nonce": "<computed nonce>",
    "appId": "<appId>",
    "sodium": "<random 20-bit int>",
    "routePath": "A84",
    "xxid": "<session xxid>"
  }
}

Field	Example	Description
accountNo	90101000000001000	Account number to fetch history for
start	0	First row (0-based, inclusive)
end	19	Last row (inclusive)
includeCount	true	Include total_count in response
trxType	0	Transaction type filter (0 = all)
sortTrx	date	Sort field
sortDir	desc	Sort direction

Pagination

Page size is 20. Compute start/end per page:

Page	start	end
1	0	19
2	20	39
N	(N-1)*20	N*20 - 1

Stop when total fetched equals total_count or data is empty.

---

Response

{
  "success": true,
  "responseCode": "1",
  "reasonCode": "103",
  "reasonText": "Trx History Retrieval Success!",
  "total_count": "87",
  "pos": "0",
  "data": [
    {
      "accountNo": "90101000000001000",
      "curCode": "462",
      "curCodeDesc": "MVR",
      "trxNumber": "1-158043140-93434633-1",
      "trxNumber2": "93434633",
      "trxDate": "2026-05-16 15:10:25",
      "trxValDate": "2026-05-16 00:00:00",
      "absAmount": "500",
      "baseAmount": "-500",
      "foreignAmount": "-500",
      "descr1": "Favara Transfer Web",
      "descr2": "<reference>",
      "descr3": "<details>",
      "remarks": "<details>",
      "trxType": "803",
      "AddDate": "2026-05-16 15:10:25",
      "bankCode": "1",
      "bankName": "Maldives Islamic Bank",
      "benefName": "BML - MOHAMED ALI",
      "otherAccountNo": "-",
      "fromAcc": null,
      "imageHash": null,
      "bankColor": "#FE860E"
    }
  ]
}

Field	Type	Description
success	bool	true on success
total_count	string	Total transaction count — parse to int
pos	string	Echo of the requested start row
data	array	Transactions for this page

Transaction Object

Field	Consumed	Description
trxNumber	yes	Unique transaction ID
trxDate	yes	Transaction timestamp (yyyy-MM-dd HH:mm:ss)
descr1	yes	Transaction description — trim whitespace
foreignAmount	yes	Amount in the account's currency — negative = debit, positive = credit
curCodeDesc	yes	Account currency (e.g. "MVR", "USD")
benefName	yes	Counterparty name — null, blank or literal "null" means none
trxNumber2	yes	Secondary reference; may be blank
baseAmount	server-only	Signed amount in MVR. Differs from foreignAmount on USD accounts.
absAmount	server-only	Unsigned MVR amount
descr2 / descr3 / remarks	server-only	Extra reference and narrative lines
trxType	server-only	Numeric transaction type (e.g. 800 Favara credit, 803 Favara transfer, 205 account-to-account)
imageHash	server-only	Counterparty image hash, fetchable via P41 (see 07-profile.md)

On USD accounts baseAmount is the MVR equivalent — always use foreignAmount for the amount shown against the account.

---

 

---

← Accounts     Next → Cards