Get All Customer Accounts - Field Descriptions

The following tables describe the fields in the response for the Get All Customer Accounts endpoint.

Header

The following table describes the fields that can be included in the header of the request.

FieldDescriptionTypeMin LengthMax LengthMandatory
client-idClient identifier for the request.StringYes
partner-idPartner identifier for Mastercard configuration. If not provided, uses the default partner ID.StringNo

Response

The following table describes the fields that are included in the response.

FieldDescription
request_idUnique identifier for the request.
customer_accountsObject that contains information on the customer account.
idThe account identifier.
numberThe account number from the institution.
accountNumberDisplayThe account number from a financial institution in truncated format:
  • Last four digits: "1234"
  • Last four digits with suffix: "1234-9"
  • Full value for string accounts: '1234-9'
nameThe account name from the institution.
balanceThe cleared balance of the account as of balanceDate.
typeThe list of supported account types. For example, checking.
statusThe status of the account. For example, pending. The
customerIdThe customer identifier.
institutionIdThe identifier of the financial institution
currencyThe currency code.
realAccountNumberLast4The last 4 digits of the ACH account number.
balanceDateThe timestamp showing when the balance was captured by the FI.
aggregationSuccessDateThe timestamp showing the last successful aggregation of the account. This will not be present until you have run your first aggregation for the account.
aggregationStatusCodeThe timestamp showing the last successful aggregation of the account. This will not be present until you have run your first aggregation for the account.
aggregationAttemptDateThe timestamp showing the last aggregation attempt, whether successful or not. This will not be present until you have run your first aggregation for the account.
createdDateThe timestamp showing when the account was added to the system.
lastUpdatedDateThe timestamp showing when the account was last modified to the system.
linkedAccountDateThe timestamp showing when the account was last linked to the system.
lastTransactionDateThe date of the latest transaction on the account. This will not be present until you have run your first aggregation for the account.
institutionLoginIdThe institution login ID (from the account record).
displayPositionThe display position of the account at the financial institution, "1" being the top listed account
accountNicknameThe account nickname.
oldestTransactionDateThe date of the oldest transaction in the transactions for the account.
marketSegmentThe market segment of the account.
detailObject that contains information on the available balance.
available_balance_amountThe available balance (typically the current balance with adjustments for any pending transactions).
detailEnd of the detail object.
customer_accountsEnd of the customer_accounts object.
countThe total number of accounts returned.