Transactions Listing
SaaS apps can fetch a list of transactions. The endpoint supports query parameters for filtering (e.g., by dates, status, type, accounts, cards) — pass filters as query parameters as applicable.
GET{baseUrl}/tme/api/v1/transactions
Response
Each item in data[] is a transaction summary.
| Field | Type | Description |
|---|---|---|
| id | Integer | Internal transaction record ID. |
| transactionId | String (UUID) | Cross-system tracking ID. |
| transactionType | String | e.g., Purchase, Transfer. |
| dateTime | String (ISO 8601) | Transaction timestamp (UTC). |
| status | String | e.g., SUCCESS, FAILED, PENDING. |
| totalCharges | Number | Total applied charges. |
| narration | String | Narrative/descriptor of the transaction. |
| card | Object | { id, lastFourDigits, cardType } — present for card transactions. |
| billingAmount | Object | { amount, currencyCode, amountType }. |
| senderAccount | Object | Sender account summary. |
| receiverAccount | Object | Receiver account summary (for transfers). |
| location | Object | { id, countryCode } — for merchant transactions. |
| merchant | Object | { id, mcc, name, city, country, countryCode } — for merchant transactions. |
200 — SUCCESS
{
"data": [
{
"id": 14756,
"transactionId": "ff5bd5cd-ca1d-413d-a98b-130ba38755b3",
"transactionType": "Purchase",
"dateTime": "2025-06-26T06:19:53.956+00:00",
"status": "SUCCESS",
"totalCharges": 30.20000000,
"narration": "POS AT W.H.Smith Signature - Edinburgh, GBR CARD NO *9066 REF NO 2367430076520220000",
"card": { "id": 21, "lastFourDigits": "9066", "cardType": "VIRTUAL" },
"billingAmount": { "amount": 100.00000000, "currencyCode": "AED", "amountType": "BILLING" },
"senderAccount": {
"id": 47,
"userId": 652,
"accountTitle": "ALI AMMAR",
"accountNumber": "************0907",
"accountType": "DIGITAL",
"iban": "AE360961000648060000907"
},
"location": { "id": 6021, "countryCode": "GBR" },
"merchant": {
"id": 6017,
"mcc": "6050",
"name": "W.H.Smith Signature",
"city": "Edinburgh",
"country": "GBR",
"countryCode": "GBR"
}
},
{
"id": 15054,
"transactionId": "da426a10-c0f9-4f45-a277-a838ce3bc1b0",
"transactionType": "Transfer",
"dateTime": "2025-06-30T05:25:37.202+00:00",
"status": "SUCCESS",
"totalCharges": 0,
"narration": "DIGITAL APP FUND TRANSFER - TO: ALI AMMAR MODE: REF NO - ",
"billingAmount": { "amount": 1000.00000000, "currencyCode": "AED", "amountType": "BILLING" },
"senderAccount": {
"id": 983,
"userId": 1966,
"accountTitle": "JOHN MOCK-DOE",
"accountNumber": "************2784",
"accountType": "DIGITAL",
"iban": "AE880961000648060002784"
},
"receiverAccount": {
"id": 47,
"userId": 652,
"accountTitle": "ALI AMMAR",
"accountNumber": "************0907",
"accountType": "DIGITAL",
"iban": "AE360961000648060000907"
}
}
]
}