Retrieve an MLT

Retrieve details for a multi-leg transaction (MLT). The response includes details for the overall MLT as well as the debit (funding leg) and credit (disbursement leg) transactions created for the MLT. You can also request details for the Financial Accounts used in the MLT debit and credit transactions.

The response includes an ETag (entity tag) header with an identifier that represents the current status of the resource. This identifier must be provided when updating an MLT.

Endpoint

GET /v1/multi-leg-transactions/{mltId}

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

mltId  REQUIRED

string (UUID)

ID of the multi-leg transaction (MLT) in the RocketKOR system.

Request Body

None

Returns

Returns an ETag (entity tag) header with an identifier that represents the current status of the resource. This identifier must be provided when updating the MLT.

Returns the MLT Detail object. This object contains detailed MLT information, including details for the MLT, details for the individual debit and credit transactions, and detailed information for the Financial Accounts used in the debit and credit transactions.

SAMPLE RESPONSE

				
					{
  "currency": "USD",
  "totalAmount": "1200.00",
  "metadata": {
    "myPaymentId": "100000333",
    "invoiceNumber": "123232333",
    "authorizedBy": "user@email.com"
  },
  "name": "MLT-123",
  "description": "",
  "memo": "",
  "initiatorAccountHolderId": "ebfa3e16-63c4-48e3-ae59-a3194a867269",
  "originatingChannel": "EXTERNAL",
  "id": "9b4aff10-ad49-4f72-ae77-204a28f60196",
  "businessAccountId": "32edfac0-edbd-47f5-aff9-a030b1883cce",
  "stage": "FUNDING",
  "status": "PENDING",
  "debitAmountPending": "1200.00",
  "debitAmountCleared": "",
  "creditAmountPending": "1200.00",
  "creditAmountSettled": "",
  "debits": [
    {
      "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"
      },
      "financialAccount": {
        "name": "Checking",
        "category": "EXTERNAL",
        "type": "BANK",
        "subtype": "CHECKING",
        "bankAccount": {
          "bankName": "Citibank",
          "nameOnAccount": "Bill Anderson"
          "routingNo": "321171184",
          "accountNumberTail": "6790",
          "businessName": "ABC Corporation",
          "address": {
            "addressLine1": "625 Queen St",
            "addressLine2": "Suite 201",
            "addressLine3": "South Building",
            "city": "Vancouver",
            "stateCode": "BC",
            "countryCode": "CAN",
            "postalCode": "V5K 0A1"
          }
        },
        "maskedAccountNumber": "******6790",
        "token": "efvm5t4cw43ef4rfvcr",
        "provider": "provider",
        "currency": "USD",
        "id": "89947c99-1ef5-4b30-ba9c-c1103196b0c9",
        "state": "ACTIVE",
        "sponsorFinancialAccountId": "",
        "financialInstitutionId": "",
        "parentId": "67874324-2c1e-4764-8712-f47600f5d402",
        "accountRoles": "DEFAULT",
        "businessAccountId": "32edfac0-edbd-47f5-aff9-a030b1883cce",
        "version": 1,
        "externalBalanceAmount": "",
        "externalBalanceEffectiveAt": "",
        "restrictions" {
          "solution": "",
          "transactionType": "",
          "withholdingPeriod": "",
          "inherited": false,
        }
      },
      "paymentReason": "Funds Transfer",
      "provider": "ACH Provider",
      "metadata": {
        "description": "my description" 
      }
    }
  ],
  "credits": [
    {
      "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"
      },
      "financialAccount": {
        "name": "Checking",
        "category": "EXTERNAL",
        "accountHolderType": "CUSTOMER",
        "type": "BANK",
        "subtype": "CHECKING",
        "bankAccount": {
          "bankName": "Citibank",
          "nameOnAccount": "Jane Smith",
          "routingNo": "321171184",
          "accountNumberTail": "4325",
          "businessName": "XYZ Company",
          "address": {
            "addressLine1": "100 Main St",
            "addressLine2": "Suite 100",
            "addressLine3": "",
            "city": "Toronto",
            "stateCode": "ON",
            "countryCode": "CAN",
            "postalCode": "M4B 2J8"
          }
        },
        "maskedAccountNumber": "******4325",
        "token": "klom5t4mn73ef5rfdvd",
        "provider": "provider",
        "currency": "USD",
        "id": "4c076ddc-0bf0-4c7c-a62d-079d7672cbec",
        "state": "ACTIVE",
        "sponsorFinancialAccountId": "",
        "financialInstitutionId": "",
        "parentId": "26b872fe-7e59-4a8e-871c-ae6543acdd85",
        "accountRoles": "DEFAULT",
        "accountHolderId": "64fff1fb-619e-4a07-80ad-ac484f2c1087",
        "businessAccountId": "32edfac0-edbd-47f5-aff9-a030b1883cce",
        "version": 1,
        "externalBalanceAmount": "",
        "externalBalanceEffectiveAt": "",
        "restrictions" {
          "solution": "",
          "transactionType": "",
          "withholdingPeriod": "",
          "inherited": false,
        }
      },
      "paymentReason": "Funds Transfer",
      "provider": "ACH Provider",
      "metadata": {
        "description": "my description"
      }
    }
  ],
  "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",
  "version": 2,
  "parentId": "01dc88fc-9e9a-47c0-b5c2-139d20356785"
}
				
			
Exit mobile version