RocketKOR

Search Transactions

Search for transactions based on filters such as the Provider, status, requestor, and receiver. 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/transactions

Authorization Header

Authorization: Bearer <access_token>

Query Parameters

createdById

string (UUID)

ID of the entity that requested the transaction creation.

createdByType

string enum, values: EMPLOYEE, CUSTOMER, SERVICE_ACCOUNT, RECIPIENT

Type of entity that requested the transaction creation.

createdDateFrom

string (date), required format: yyyy-MM-dd

Date the transaction was created in the RocketKOR system. This filter will return transactions created on or after this date.

Note  The date is interpreted using the specified timeZone. UTC format is used if timeZone is not provided.

createdDateTo

string (date), required format: yyyy-MM-dd

Date the transaction was created in the RocketKOR system. This filter will return transactions created on or before this date.

Note  The date is interpreted using the specified timeZone. UTC format is used if timeZone is not provided.

timeZone

string (timeZone)

default: 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)

amountFrom

number

Amount of the transaction. This filter will return transactions with an amount equal to or greater than this amount.

amountTo

number

Amount of the transaction. This filter will return transactions with an amount equal to or less than this amount.

latestStatus

string enum, values: NEW, PENDING, PROCESSING, APPROVED, SETTLED, CLEARED, CANCELLED, DECLINED, REVERSED, ERROR

Transaction status. Possible values are:
  • NEW  The transaction has been created in RocketKOR.
  • PENDING  The transaction has been moved from the Transaction Domain to one of the Processing Domains. The transaction is still in the RocketKOR system (meaning it has not been transmitted to the Provider for processing) and is in a state where it can be cancelled.
  • PROCESSING  One of the following is true: (a) the transaction is in a Processing Domain in the RocketKOR system but can no longer be cancelled, or (b) the transaction has been transmitted to the Provider for processing.
  • APPROVED  Disbursement has been approved by the Provider.
  • SETTLED  The transaction has been settled by the Provider.
  • CLEARED  The Sponsor has indicated that funds movement for the transaction is complete. The funds are now available in the Master Settlement Account (MSA). This status is only applicable to “received” transactions.
  • CANCELLED  The transaction has been cancelled.
  • DECLINED  Disbursement has been declined by the Provider.
  • REVERSED  A transaction was submitted by RocketKOR to move funds in the opposite direction of the initial transaction. This “reverses” the transaction by moving the funds back to the original account.
  • ERROR  The transaction could not be processed due to one or more errors (for example, the Provider system is unavailable after a number of retries). The Error status is only activated after RocketKOR determines that it cannot continue processing the transaction.

maskedDebitAccountNumber

string

Masked account number for the bank account or card account used as the debit account for the transaction. Enter the last 4 digits of the account number (for example: 4242). Optionally, you can enter asterisks for the rest of the account number (for example: ********4242).

maskedCreditAccountNumber

string

Masked card number for the bank account or card account used as the credit account for the transaction. Enter the last 4 digits of the account number (for example: 4242). Optionally, you can enter asterisks for the rest of the account number (for example: ********4242).

solution

string enum, values: push-to-card, ach

Name of the RocketKOR solution used for the transaction. Possible values are:

  • push-to-card  Push to Card solution.
  • ach  ACH solution.

transactionType

string enum, values: SEND, REQUEST, REVERSAL

Type of transaction. Possible values are:

  • SEND  Push funds from a Financial Account to another Financial Account.
  • REQUEST  Pull funds to a Financial Account from another Financial Account.
  • REVERSAL  A transaction created by RocketKOR to reverse a SETTLED or CLEARED transaction.
SEND, REQUEST, and REVERSAL transactions are originated on RocketKOR.

batchId

string (UUID)

ID of the batch that the transaction originated from.

page

integer (int32)

Page number to return, based on zero-based page index.

size

integer (int32)

Maximum number of results to return per page.

sort

array [string]

Sort the response by any field in ascending or descending order. For details, see Sorting and Pagination. The default sort order is createdAt,DESC.

Request Body

None

Returns

Returns a paginated response with an array of Transaction objects.

SAMPLE RESPONSE

				
					{
  "totalElements": 100,
  "totalPages": 100,
  "number": 1,
  "numberOfElements": 1,
  "hasNext": true,
  "content": [
    {
      "id": "2av81w47-9367-1295-h4ng-1q520p28wfn1",
      "businessAccountId": "4hy47a98-2453-9867-u3qa-5p347q98kim4",
      "metadata": {
        "myPaymentId": "100000333",
        "invoiceNumber": "123232333",
        "authorizedBy": "user@email.com"
      },
      "debitFinancialAccountId": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
      "creditFinancialAccountId": "4py56a34-4686-1539-c2ga-1a723g55dlq3",
      "transactionType": "SEND",
      "solution": "ach",
      "paymentReasonId": "loan-payouts",
      "paymentReason": "Loan Payouts",
      "amount": "1000.00",
      "currency": "USD",
      "settlementPriority": "SAME_DAY",
      "latestStatus": {
        "status": "NEW",
        "message": "Transaction creation successful",
        "createdAt": "2021-07-01T17:40:22.601Z"
      },
      "createdAt": "2021-07-01T17:40:22.601Z",
      "createdBy": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "type": "EMPLOYEE"
      },
      "reversalReason": ""
    },
    {...},
    {...}
  ]
}