Get Bulk Transaction Filtered By Date

This API allows merchants to retrieve a list of their transactions within a specified date range. Results are paginated and include key financial breakdowns such as VAT, MDR, and processing fees.

GETbaseUrl/api/v1/b2b/transactions/

Headers

• Authorization: Bearer {{accessToken}} (Include the token obtained from the Authentication API)
• Content-Type: application/json

Parameters

Parameter	Type	Required	Description
startDate	string	Yes	Start of the date range, format YYYY-MM-DD.
endDate	string	Yes	End of the date range, format YYYY-MM-DD.

Example Request

GET /api/v1/b2b/transactions/filter?startDate={YYYY-MM-DD}&endDate={YYYY-MM-DD}
Authorization: Bearer {{accessToken}}
Content-Type: application/json

Response

A successful response returns a paginated JSON object containing the matching transactions:

Example Response

{
            "transactionId": 11288,
            "status": "APPROVED",
            "transactionDate": "09/03/2026",
            "transactionTime": "21:04:16",
            "uuid": "c6494c18-b886-3317-b741-254e496cac78",
            "amount": "2500.00",
            "mdr": "250.00",
            "vat": "37.50",
            "netAmount": "1962.50",
            "procFee": "250.00",
            "rrn": "606821000489",
            "cardType": "mada",
            "acquirerCode": "RAJB",
            "merchantAr": "313233343536",
            "merchantEn": "RAJB Testing NeoLeap",
            "addAr": "333231",
            "addEn": "KAFD",
            "merchantId": "803000000324   ",
            "merchantCategoryCode": null,
            "stan": "000489",
            "madaAppVersion": "1.2.51",
            "cardSchemeAr": "مدى",
            "cardSchemeEn": "mada",
            "transactionTypeAr": "شراء",
            "transactionTypeEn": "Purchase",
            "pan": "529415******8565",
            "cardExpiration": "24/10",
            "amountAuthorizedValue": "2500.00",
            "amountAuthorizedAr": "مبلغ الشراء",
            "amountAuthorizedEn": "PURCHASE AMOUNT",
            "statusMessageAr": "مقبولة",
            "statusMessageEn": "APPROVED",
            "verificationMethodAr": "تم التحقق بتوقيع العميل",
            "verificationMethodEn": "CARDHOLDER VERIFIED BY SIGNATURE",
            "approvalCodeAr": "رمز الموافقة",
            "approvalCodeEn": "Approval Code",
            "approvalCodeValue": "U5MUZ5",
            "startDate": "09/03/2026",
            "startTime": "21:04:36",
            "endDate": "09/03/2026",
            "endTime": "21:04:36",
            "thanksMessageAr": "شكرا لاستخدامكم مدى",
            "thanksMessageEn": "Thank you for using mada",
            "saveReceiptMessageAr": "يرجى الاحتفاظ بالفاتورة",
            "saveReceiptMessageEn": "please retain receipt",
            "entryMode": "CONTACTLESS",
            "actionCode": "000",
            "applicationIdentifier": "A0000002281010",
            "terminalVerificationResult": "0040048000",
            "transactionStateInformation": "0000",
            "cardholaderVerficationResult": null,
            "cryptogramInformationData": null,
            "applicationCryptogram": "00",
            "kernelId": "02",
            "paymentAccountReference": null,
            "providerResponseCode": "00",
            "switchResponseCode": "000"
}

Usage Tips

1. Use startDate and endDate to limit results and retrieve transactions in that specific date range.
2. Default pageSize is 15 transactions per page. Use pagination controls to retrieve more records.
3. Recommended for B2B merchants to integrate directly into their internal reporting systems.