Get Accounts History Details (GQL)

Note: All the GQL API's have the endpoint: /graphql

Use this API to retrieve the transaction history of an account, including completed and authorized (held) transactions.

Retrieves detailed information about a specific account transaction history event. This includes the type and subtype of the transaction (e.g., withdrawal, transfer authorization), and any associated entities such as an authorization hold or card authorization.

Body Params

These are the parameters used to retrieve the transaction history for a specific account.

Query Parameters

ParameterDescriptionMandatoryData TypeExample
typeOfType of transaction event (e.g., HOLD_AMOUNT, TRANSFER).YesStringHOLD_AMOUNT
transactionTypeMain type of transaction.YesStringWITHDRAWAL
transactionSubTypeSub-category under transactionType (e.g., TRANSFER_AUTHORIZATION).OptionalStringTRANSFER_AUTHORIZATION
subTransactionTypeFurther classification of the transaction, if applicable.OptionalStringnull
attachmentsList of attachment URLs related to the transaction.OptionalArray[ { "url": "..." } ]
savingsAccountTransactionDetails if linked to a savings account.OptionalObject{ id, amount, ... }
idTransaction ID.YesInteger452
amountAmount of the savings transaction.YesDecimal200.00
runningBalanceAccount balance after the transaction.YesDecimal1250.00
bookingDateDate the transaction was booked.YesString2025-04-07
createdAtTimestamp of when transaction was created.YesString2025-04-07 10:05:30
paymentDetailDataMetadata about the payment (type, parties involved, card data, etc.).OptionalObject{ reference, creditor, ... }
transferDataData related to the transfer, including payment rail metadata.OptionalObject{ paymentRailMetaData }
authorizeTransactionAuthorization hold details.OptionalObject{ id, amount, transfer, ... }
idID of the authorization transaction.YesInteger7724
typeOfType of authorization (e.g., HOLD_AMOUNT).YesStringHOLD_AMOUNT
activeWhether the authorization is still active.YesBooleantrue
createdAtTimestamp when authorization was created.YesString2025-04-07 23:06:10
amountAuthorized amount.YesDecimal7.84
referenceReference ID, if available.OptionalStringnull
transferAssociated transfer details including parties and metadata.OptionalObject{ id, type, creditor, ... }
transactionNested transaction detail with payment and card authorization metadata.OptionalObject{ paymentDetail: {...} }
accountAccount linked to the authorization.OptionalObject{ id: 1590 }
cardAuthorizationDetails of a card authorization event, if applicable.OptionalObject{ id, amount, status, ... }
idCard authorization ID.YesInteger562
currencyCurrency used in the authorization.YesStringUSD
createdAtTimestamp of card authorization creation.YesString2025-04-07 22:15:00
statusCurrent status of the card authorization.YesStringAPPROVED
expiryDateExpiry date of the authorization.OptionalString2025-04-09
amountTotal amount authorized.YesDecimal100.00
transactionTransaction type related to the card use.YesStringPURCHASE
merchantName of the merchant.YesStringAmazon
authTypeType of authorization (e.g., EMV, Contactless).OptionalStringCONTACTLESS
transactionTypeType of transaction performed using the card.OptionalStringONLINE_PURCHASE
executionCodeCode representing the result of execution.OptionalString00
executionMessageHuman-readable message of the execution result.OptionalStringTransaction approved
internationalWhether the transaction was international.OptionalBooleantrue
amountDetailsBreakdown of the authorized amount.OptionalObject{ feeAmount, localCurrency, ... }
cardCard used for the transaction, includes PAN and ID.OptionalObject{ id, primaryAccountNumber }
Headers
string
required
Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json