RocketKOR

Search Multi-Leg Transactions

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.

Endpoint

GET /v1/multi-leg-transactions

Authorization Header

Authorization: Bearer <access_token>

Query Parameters

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:

  • Z, UTC or GMT  UTC
  • {+,-}N(N)(:MM)  Zone offset in hours and minutes
  • UTC+<offset>, UTC-<offset>, GMT+<offset>, GMT-<offset>
  • IANA Time Zone Database region ID (example: the value for America/New_York is -04)

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:

  • FUNDING  A new MLT has been created in RocketKOR. The MLT will remain in the FUNDING stage until all of the debit (funding leg) transactions have cleared or the MLT is cancelled.
  • DISBURSING  The debit (funding leg) transactions have cleared, and the MLT has transitioned to the disbursement leg.
  • CANCELLING  The MLT has been cancelled.

status

string enum, values: PENDING, PROCESSING, FAILED, CANCELLED, COMPLETE

Current status of the multi-leg transaction (MLT). The following values are supported:

  • PENDING  The MLT is waiting to be processed.
  • PROCESSING  The MLT debit (funding leg) and credit (disbursement leg) transactions are being processed.
  • FAILED  One or more of the MLT transactions has failed. Other transactions may in process or completed. For possible ways to resolve a failed MLT, see the Update an MLT and Cancel an MLT APIs.
  • CANCELLED  The MLT has been cancelled.
  • COMPLETE  The MLT credit (disbursement leg) transactions have been completed.

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:

  • fromAccountHolderId  ID of the account holder for the debit Financial Account.
  • fromFinancialAccount  Details for the debit Financial Account.
  • toAccountHolderId  ID of the account holder for the credit Financial Account.
  • toFinancialAccount  Details for the credit Financial Account.

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.

Request Body

None

Returns

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"
    },
    {...},
    {...}
  ]
}