GET STARTED

RECIPIENT

FINANCIAL ACCOUNT

PAYMENT REASON

TRANSACTION

NOTE

Retrieve Recipient Default Financial Account

Retrieve the details for a recipient’s default Financial Account. The response includes details about the Financial Account, as well as details for the card or bank account linked to the Financial Account.

Endpoint

GET /api/external/recipients/{recipientId}/financial-accounts/default

Authorization Header

Basic Auth  REQUIRED

username is your API key ID and password is your API key secret.

Path Parameters

recipientId  REQUIRED

string (UUID)

Recipient Account ID. The default Financial Account will be retrieved for this account.

Request Body

None

Returns

Returns details for the recipient’s default Financial Account. The following fields are returned.

id

string (UUID)

Unique ID assigned to the Financial Account.

createdAt

string (date-time), required format: yyyy-MM-dd’T’HH:mm:ss.SSSz

Date and time the Financial Account was created.

updatedAt

string (date-time), required format: yyyy-MM-dd’T’HH:mm:ss.SSSz

Date and time the Financial Account was last updated.

name

string, max length: 40, min length: 0

Name for the Financial Account.

accountId

string (UUID)

ID of the account that owns the Financial Account. This could be a Recipient Account or a Business Account.

accountIdType

string enum, values: RECIPIENT, BUSINESS_ACCOUNT

Type of account that owns the Financial Account. This could be a Recipient Account (RECIPIENT) or a Business Account (BUSINESS_ACCOUNT).

defaultFlag

boolean (true, false)

Whether this the default Financial Account for transactions.

state

string enum, values: ACTIVE, SUSPENDED

Current status of the Financial Account. Possible values are ACTIVE (account is active) and SUSPENDED (account is inactive). A Financial Account is ACTIVE when first created.

financialInstitutionId

string (UUID)

Unique ID for the financial institution that issued the card. This is an internal ID used by RocketKOR.

financialInstitutionName

string, max length: 40, min length: 0

Name of the financial institution that issued the card.

ledgerIds

array of strings (UUID)

Accounting ledgers associated with the Financial Account.

 

The following fields are returned if the default Financial Account is a card account.

card

object

Details for the card.

id

string (UUID)

Unique ID assigned to the card.

token

string (UUID)

Random alphanumeric token for the card details.

firstName

string, max length: 40, min length: 0

Recipient’s first name as it appears on the card.

middleName

string, max length: 40, min length: 0

Recipient’s middle name as it appears on the card.

lastName

string, max length: 40, min length: 0

Recipient’s last name as it appears on the card.

type

string enum, values: DEBIT

Type of card.

expiry

object

Expiry information for the card.

year

integer (int32)

Expiry year.

month

string enum, values: JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER

Expiry month.

monthValue

integer (int32), values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12

Expiry month as a numeral.

leapYear

boolean (true, false)

Whether the expiry year is a leap year.

billingAddress

object

Billing address for the card.

addressLine1

string, max length: 50, min length: 0

Address line 1.

addressLine2

string, max length: 50, min length: 0

Address line 2.

addressLine3

string, max length: 50, min length: 0

Address line 3.

city

string, max length: 25, min length: 0

City.

state

string, max length: 3, min length: 2

State or province.

country

string, max length: 3, min length: 3

3-digit country code.

postalCode

string, max length: 10, min length: 0

ZIP code or postal code.

cardNumberTail

string

Last 4 digits of the card number.

 

The following fields are returned if the default Financial Account is a bank account.

bankAccount

object

Details for the bank account.

id

string (UUID)

Unique ID assigned to the bank account.

token

string (UUID)

Random alphanumeric token for the bank account details.

type

string enum, values: CHECKING, SAVING

Type of bank account.

businessName

string

Business name as it appears on the bank account.

bankName

string

Name of the financial institution.

routingNo

string

Routing number for the financial institution.

nameOnAccount

string

Name of the bank account owner.

accountNumberTail

string

Last 4 digits of the bank account number.

SAMPLE RESPONSE

				
					{
  "id": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
  "createdAt": "2021-07-08T21:10:51.610Z",
  "updatedAt": "2021-07-08T21:10:51.610Z",
  "name": "Debit Card",
  "accountId": "4py56a34-4686-1539-c2ga-1a723g55dlq3",
  "accountIdType": "RECIPIENT",
  "defaultFlag": true,
  "state": "ACTIVE",
  "financialInstitutionId": "8th32z87-3845-9810-v7gu-1f827g98swk3",
  "financialInstitutionName": "CIBC",
  "ledgerIds": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "card": {
    "id": "7wu45p35-2178-3098-x6wg-2s749k37alk2",
    "token": "2av81w47-9367-1295-h4ng-1q520p28wfn1",
    "firstName": "Mark",
    "middleName": "David",
    "lastName": "Strong",
    "type": "DEBIT",
    "expiry": {
      "year": 2022,
      "month": "JANUARY",
      "monthValue": 1,
      "leapYear": false
    },
    "billingAddress": {
      "addressLine1": "625 Queen St",
      "addressLine2": "",
      "addressLine3": "",
      "city": "Vancouver",
      "state": "BC",
      "country": "Canada",
      "postalCode": "V5K 0A1"
    },
    "cardNumberTail": "6999"
  }
}