Skip to main content
GET
/
v2
/
open-banking
/
bank-accounts
/
{bank_account_id}
Retrieve a bank account
curl --request GET \
  --url https://api-sandbox.argyle.com/v2/open-banking/bank-accounts/{bank_account_id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": "8057637863",
  "user": "01975b3b-5ba6-3ec1-2148-f595b6d92614",
  "account_number_display": "2203",
  "name": "Savings",
  "type": "savings",
  "aggregation_status_code": 0,
  "status": "active",
  "institution": "102168",
  "aggregation_success_date": "2026-06-04T16:57:26.000Z",
  "aggregation_attempt_date": "2026-06-04T16:57:26.000Z",
  "created_date": "2026-06-04T16:57:17.000Z",
  "currency": "USD",
  "institution_login": 8029158291,
  "display_position": 1,
  "parent_bank_account": null,
  "linked_account_date": "2026-06-04T16:57:22.000Z",
  "error_code": null,
  "error_message": null,
  "real_account_number_last4": "2203",
  "balance": 22327.3,
  "balance_date": "2026-06-04T16:57:26.000Z",
  "last_updated_date": "2026-06-04T16:57:22.000Z",
  "market_segment": "personal",
  "last_transaction_date": "2026-06-04T16:57:23.000Z",
  "oldest_transaction_date": "2024-06-08T12:00:00.000Z"
}

Authorizations

Authorization
string
header
required

Username = api_key_id, Password = api_key_secret

Path Parameters

bank_account_id
string
required

ID of the bank account.

Query Parameters

user
string<uuid>
required

ID of the user.

Response

200 - application/json
id
string

ID of the bank account.

user
string<uuid>

ID of the user associated with the bank account.

account_number_display
string

Display account identifier.

name
string

Account name.

type
enum<string>

Bank account type.

Available options:
checking,
savings,
cd,
moneyMarket,
creditCard,
lineOfCredit,
investment,
investmentTaxDeferred,
employeeStockPurchasePlan,
ira,
401k,
roth,
403b,
529plan,
rollover,
ugma,
utma,
keogh,
457plan,
401a,
brokerageAccount,
educationSavings,
healthSavingsAccount,
pension,
profitSharingPlan,
roth401k,
sepIRA,
simpleIRA,
thriftSavingsPlan,
variableAnnuity,
cryptocurrency,
mortgage,
loan,
studentLoan,
studentLoanGroup,
studentLoanAccount
aggregation_status_code
integer

Status code of the most recent aggregation attempt.

See Aggregation status codes.

status
enum<string>

Bank account status.

Available options:
pending,
active
institution
string

ID of the financial institution.

aggregation_success_date
string<date-time>

Timestamp (ISO 8601) of the last successful aggregation for the account.

aggregation_attempt_date
string<date-time>

Timestamp (ISO 8601) of the last aggregation attempt for the account, whether successful or not.

created_date
string<date-time>

Timestamp (ISO 8601) for when the bank account was created.

currency
string

Currency code.

institution_login
integer

ID of the institution login.

display_position
integer

Display position of the account at the financial institution.

parent_bank_account
string

ID of the parent bank account.

linked_account_date
string<date-time>

Timestamp (ISO 8601) for when the account was linked.

error_code
string

Bank connection error code.

error_message
string

Bank connection error message.

real_account_number_last4
string

Last four digits of the account number.

balance
number

Account balance amount.

balance_date
string<date-time>

Timestamp (ISO 8601) for when the balance was recorded.

last_updated_date
string<date-time>

Timestamp (ISO 8601) for when the account was last updated.

market_segment
enum<string>

Indicates whether the account is personal or business.

Available options:
personal,
business
last_transaction_date
string<date-time>

Timestamp (ISO 8601) of the latest transaction.

oldest_transaction_date
string<date-time>

Timestamp (ISO 8601) of the oldest transaction.