Validate recipients and retrieve disbursement status for Brick Send Money workflows. Use these endpoints with Regular or BI-FAST payouts to reconcile by Brick disbursement ID or your own reference ID.
Disbursement Account Validation
Validate a recipient bank account before creating a disbursement. Send the bank code and account number to confirm whether the destination account can receive a payout and, when available, review the returned account holder information. Use this check during beneficiary creation, payout review, or pre-transfer validation to reduce failed and misdirected transfers.
query Parameters
accountNumberThe bank account number to be verified.
bankShortCodeThe short code of the bank institution. Refer to the Supported Banks List for valid codes.
Headers
activityIdOptional tracking identifier provided by the client. If omitted, Brick will automatically generate a unique activityId. This value is returned in the response for end-to-end transaction tracing.
Disbursement Account Validation › Responses
200
statuserrorCheck Disbursement Status using Disbursement ID
Retrieve the latest disbursement status by Brick disbursement ID. Use this endpoint after creating a Regular or BI-FAST payout when your system has stored the Brick-generated disbursement identifier. The response helps support, operations, and reconciliation systems confirm whether a payout is processing, completed, failed, or requires further investigation.
path Parameters
disbursementIdDisbursement ID of the transaction
Check Disbursement Status using Disbursement ID › Responses
200
statuserrorCheck Disbursement Status using Reference ID
Retrieve the latest disbursement status by your client-provided reference ID. Use this endpoint when internal orders, payout batches, or support cases are keyed by your own reference instead of the Brick disbursement ID. The response connects your business transaction to Brick payout state for reconciliation and customer communication.
query Parameters
referenceIdReference ID from given from Client Side
Check Disbursement Status using Reference ID › Responses
200
statuserror