Search for multi-leg transactions (MLTs) based on filters such as the MLT creation date, transaction amount, and requestor. Use the sort query parameter to sort the results, and use the page and size query parameters to limit the number of results returned.
Note The search is limited to transactions for the Business Account associated with the request access token.
GET /v1/multi-leg-transactions
Authorization: Bearer <access_token>
createdDateFrom
string (date), format: yyyy-MM-dd
Date the multi-leg transaction (MLT) was created in the RocketKOR system. This filter will return MLTs created on or after this date.
Note The date is interpreted using the time zone specified in the timeZone filter. UTC format is used if timeZone is not provided.
createdDateTo
string (date), format: yyyy-MM-dd
Date the multi-leg transaction (MLT) was created in the RocketKOR system. This filter will return MLTs created on or before this date.
Note The date is interpreted using the time zone specified in the timeZone filter. UTC format is used if timeZone is not provided.
timeZone
string (timeZone), default value: UTC
Time zone for the createdDateFrom and createdDateTo filters. The following values are supported:
debitFinancialAccountId
string (UUID)
ID of the debit Financial Account. This account is used in the MLT funding leg.
creditFinancialAccountId
string (UUID)
ID of the credit Financial Account. This account is used in the MLT disbursement leg.
maskedDebitAccountNumber
string
Masked account number of the debit Financial Account. This account is used in the MLT funding leg.
maskedCreditAccountNumber
string
Masked account number of the credit Financial Account. This account is used in the MLT disbursement leg.
totalAmountFrom
number
Total amount of the multi-leg transaction (MLT). This filter will return MLTs with an amount equal to or greater than this amount.
totalAmountTo
number
Total amount of the multi-leg transaction (MLT). This filter will return MLTs with an amount equal to or less than this amount.
name
string
Descriptive name for the multi-leg transaction (MLT).
stage
string enum, values: FUNDING, DISBURSING, CANCELLING
Current stage of the multi-leg transaction (MLT). The following values are supported:
status
string enum, values: PENDING, PROCESSING, FAILED, CANCELLED, COMPLETE
Current status of the multi-leg transaction (MLT). The following values are supported:
parentId
string (UUID)
ID of the schedule that created the multi-leg transaction (MLT). Applies to scheduled MLTs only.
embed
string, values: fromAccountHolderId, fromFinancialAccount, toAccountHolderId, toFinancialAccount
Specify subresources to embed in the response. The following subresources can be requested:
Use a comma-separated list to return multiple subresources (example: fromAccountHolderId,toAccountHolderId).
sort
array [string]
Sort the response by any field in ascending or descending order. The default sort order is createdAt,DESC. For more information, see Sorting and Pagination.
page
integer (int32)
Page number to return, based on zero-based page indexing.
size
integer (int32)
Maximum number of results to return per page.
None
Returns a paginated response with an array of Multi-Leg Transaction Summary objects. This object contains summary details for the overall MLT as well as the debit (funding leg) and credit (disbursement leg) transactions created for the MLT.
SAMPLE RESPONSE
{
"totalElements": 3,
"totalPages": 1,
"number": 0,
"numberOfElements": 3,
"hasNext": false,
"content": [
{
"id": "9b4aff10-ad49-4f72-ae77-204a28f60196",
"stage": "FUNDING",
"status": "PENDING",
"name": "MLT-123",
"description": "",
"memo": "",
"metadata": {
"myPaymentId": "100000333",
"invoiceNumber": "123232333",
"authorizedBy": "user@email.com"
},
"currency": "USD",
"totalAmount": "1200.00",
"debitLegs": [
{
"sequence": 0,
"financialAccountId": "89947c99-1ef5-4b30-ba9c-c1103196b0c9",
"maskedAccountNumber": "******6790",
"paymentReasonId": "funds_transfer",
"amount": "1200.00",
"amountPercentage": "",
"settlementPriority": "SAME_DAY",
"transactionId": "c0555c1a-0699-4ff4-aa9d-cd2724832be4",
"solution": "ach",
"latestStatus": {
"status": "NEW",
"message": "2023-12-11T01:09:27.246Z",
"createdBy": {
"id": "5618f9c9-bc6d-44cc-9eb8-abf76824592b",
"type": "employee"
},
"createdAt": "2023-12-11T01:09:27.246Z"
},
"_embedded": {
"financialAccount": {
"name": "Checking",
"category": "EXTERNAL",
"accountHolderType": "CUSTOMER",
"type": "BANK",
"subtype": "CHECKING",
"bankAccount": {
"bankName": "Citibank",
"nameOnAccount": "Mark Strong"
},
"maskedAccountNumber": "******6790"
},
"accountHolderId": "99b501a9-37c9-4868-ae3e-34ffbd28a1c8"
},
"financialAccount": {...} // This object has been deprecated.
}
],
"creditLegs": [
{
"sequence": 0,
"financialAccountId": "4c076ddc-0bf0-4c7c-a62d-079d7672cbec",
"maskedAccountNumber": "******4325",
"paymentReasonId": "funds_transfer",
"amount": "1200.00",
"amountPercentage": "",
"settlementPriority": "SAME_DAY",
"transactionId": "f0e04c6d-d293-47a1-bdec-dc56ccef8de4",
"solution": "ach",
"latestStatus": {
"status": "NEW",
"message": "2023-12-11T01:09:27.246Z",
"createdBy": {
"id": "5618f9c9-bc6d-44cc-9eb8-abf76824592b",
"type": "employee"
},
"createdAt": "2023-12-11T01:09:27.246Z"
},
"_embedded": {
"financialAccount": {
"name": "Checking",
"category": "EXTERNAL",
"accountHolderType": "CUSTOMER",
"type": "BANK",
"subtype": "CHECKING",
"bankAccount": {
"bankName": "Citibank",
"nameOnAccount": "Jane Smith"
},
"maskedAccountNumber": "******4325"
},
"accountHolderId": "64fff1fb-619e-4a07-80ad-ac484f2c1087"
},
"financialAccount": {...} // This object has been deprecated.
}
],
"createdBy": {
"id": "5618f9c9-bc6d-44cc-9eb8-abf76824592b",
"type": "employee"
},
"createdAt": "2023-12-11T01:09:27.246Z",
"updatedBy": {
"id": "5618f9c9-bc6d-44cc-9eb8-abf76824592b",
"type": "employee"
},
"updatedAt": "2023-12-12T01:09:27.246Z"
},
{...},
{...}
]
}
Step into the future of Finance with RocketKOR! Simplify payments, banking, lending, and data analytics using our versatile KOR Platform.
A Rocket Financial Inc. company
@ 2024 RocketKOR, Inc. All rights reserved.