GET

Get account

language https://api.araucaria.money/v1/accounts/{id}

Returns details of a specific account, including current balance and institution information. Investment accounts (brokerage, pension) include positions.

Parameters

Name	Type	Description
id *	path string

Request Example

bash

curl -X GET "https://api.araucaria.money/v1/accounts/{id}" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example

200 OK

json

{
  "id": "acc_01HQ3K5J7X8Y9Z0A1B2C3D4E5F",
  "connectionId": "conn_01HQ3K5J7X8Y9Z0A1B2C3D4E5F",
  "name": "Cuenta Corriente",
  "type": "checking",
  "currency": "CLP",
  "balance": 1250000,
  "availableBalance": 1150000,
  "accountNumber": "****6789",
  "createdAt": "2024-01-15T10:30:00Z",
  "lastSyncedAt": "2024-01-15T14:30:00Z",
  "institution": {
    "id": "cl_banco_estado",
    "name": "Banco Estado",
    "logo": null
  }
}

Response Fields

Field	Type	Description
id *	string	Unique account identifier
connectionId *	string	Connection this account belongs to
name *	string	Account display name
type *	"checking" \| "savings" \| "credit_card" \| "brokerage" \| "pension"	Account type
currency *	string	Primary currency code
balance *	number	Current balance
availableBalance *	number	Available balance (may differ from balance for credit cards)
accountNumber *	string	Masked account number
createdAt *	string	When the account was created
lastSyncedAt	object	When the account was last synced
institution	any	Institution information
creditLimit	object	Credit limit (only for credit_card accounts)
currencyBalances	CurrencyBalanceDto[]	Secondary currency balances (only for multi-currency credit cards)
positions	PositionDto[]	Investment positions (only for brokerage/pension accounts)