RocketKOR

Design  /  Financial Account Use Cases  /  Business  /  List All Business Financial Accounts

List All Business Financial Accounts

Overview

In this use case, we’ll walk through retrieving all Financial Accounts belonging to a Business Account. The response includes details for each Business Financial Account, including details for the card or bank account linked to the Financial Account.

Note  Business Financial Accounts will be retrieved for the Business Account associated with the access token included in the request.

API Operation

Steps

Send a request to the following endpoint:

GET /v1/financial-accounts

  • Include an Authorization header with your RocketKOR access token as a Bearer Token.
  • Filter the results based on the Financial Account type and state.
  • Use the sort query parameter to sort the results.
  • Use the page and size query parameters to limit the number of results returned.
  • Request body is not required.

Sample Response

Returns a paginated response with an array of Card Summary objects (for card-based Financial Accounts) and Bank Account Summary objects (for bank account Financial Accounts). Details are returned for each Financial Account.

In the following example, two Business Financial Accounts have been retrieved for the Business Account: a debit card and a bank account.

				
					{
  "totalElements": 100,
  "totalPages": 50,
  "number": 1,
  "numberOfElements": 2,
  "hasNext": true,
  "content": [
    {
      "accountType": "EXTERNAL",
      "accountHolderId": "8eb2a485-c074-40ac-a6e4-7a49e442ce45",
      "accountHolderType": "RECIPIENT",
      "id": "90dcbd64-b1fa-4429-adeb-4d5e8dcf90d7",
      "businessAccountId": "26b0ef39-72e9-4b0a-a183-9f1142083f03",
      "name": "Debit Card",
      "defaultFlag": false,
      "currency": "USD",
      "state": "ACTIVE",
      "createdAt": "2022-07-14T21:41:28.111137Z",
      "updatedAt": "2022-07-14T21:41:28.111137Z",
      "card": {
        "type": "DEBIT",
        "cardNumberTail": "4242"
      },
    },
    {
      "accountType": "EXTERNAL",
      "accountHolderId": "8eb2a485-c074-40ac-a6e4-7a49e442ce45",
      "accountHolderType": "RECIPIENT",
      "id": "1bb964b2-9825-46d8-ba77-ac64079bc72d",
      "businessAccountId": "26b0ef39-72e9-4b0a-a183-9f1142083f03",
      "name": "Checking Account",
      "defaultFlag": false,
      "currency": "USD",
      "state": "ACTIVE",
      "createdAt": "2022-07-14T21:41:28.111137Z",
      "updatedAt": "2022-07-14T21:41:28.111137Z",
      "bankAccount": {
        "type": "CHECKING",
        "accountNumberTail": "4523"
      }
    }
  ]
}
				
			
ON THIS PAGE