Business Insights: Search Financial Account Activity

Gather Business Insights (BI) by analyzing the ledgers for one or more Financial Accounts.

Use this API to search ledgers based on filters such as the transaction type and amount. The API returns a queryId that can be used to query the search status and retrieve the results.

Note The search is limited to the Business Account associated with the request access token.

Endpoint

POST /v1/search/ledger

Authorization Header

Authorization: Bearer <access_token>

Request Body

financialAccountIds REQUIRED

string (UUID)

List of Financial Account IDs to include in the search. These accounts must belong to the Business Account associated with the request access token.

fromCreatedAt

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

Date the ledger entry was created in RocketKOR. This filter will return entries created on or after this date.

toCreatedAt

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

Date the ledger entry was created in RocketKOR. This filter will return entries created on or before this date.

fromAmount

number

Amount of the ledger entry. This filter will return entries with an amount equal to or greater than this amount.

toAmount

number

Amount of the ledger entry. This filter will return entries with an amount equal to or less than this amount.

movementType

string enum, values: DEBIT, CREDIT

Type of ledger entry (DEBIT or CREDIT). If movementType is provided, transactionType will be ignored.

transactionType

string enum, values: SEND, REQUEST, DEPOSIT, WITHDRAWAL, REVERSAL, RETURN, ADJUSTMENT

Type of transaction. Possible values are:

SEND Push funds from a Financial Account to another Financial Account. SEND transactions are originated on RocketKOR.
REQUEST Pull funds to a Financial Account from another Financial Account. REQUEST transactions are originated on RocketKOR.
DEPOSIT Push funds into a Financial Account where the push is originated outside RocketKOR.
WITHDRAWAL Pull funds from a Financial Account where the pull is originated outside RocketKOR.
REVERSAL A transaction created by RocketKOR to reverse a SETTLED or CLEARED transaction.
RETURN A RETURN transaction cancels the original transaction.
ADJUSTMENT An ADJUSTMENT transaction is used to correct a human or system error with a transaction, or to record a transaction that originated outside of RocketKOR.

If movementType is provided, transactionType will be ignored.

resultFormat

string enum, values: CSV, JSON

Type of file used to store the search results.

Returns

Returns a queryId to be used with the BI Financial Account Activity Search Results API.

queryId

string (UUID)

ID representing the search results.

SAMPLE REQUEST

				
					{
  "financialAccountIds": [
    "b0a38132-df41-4cd3-9ae9-c655c46ad50b"
  ],
  "fromCreatedAt": "2023-01-01",
  "toCreatedAt": "2023-01-31",
  "fromAmount": 1000.00,
  "toAmount": 5000.00,
  "movementType": [
    "DEBIT"
  ],
  "transactionType": [
    "SEND"
  ],
  "resultFormat": "CSV"
}

SAMPLE RESPONSE

				
					{
  "queryId": "01e3488a-f668-431f-93dc-96c5dc368f96"
}