Get account

Returns the box’s AccountLink: source, payment/credit slots, paymentMode, and alertSettings. Works for manual, bank, and crypto.

GET/v1/get_account

Query

Field	Type	Required	Default	Description
budgetId	string	Yes	—	Budget that owns the box.
boxId	string	Yes	—	Box whose funding link to load.

Response `data`

Field	Type	Description
budgetId	string	Id of the budget this resource belongs to.
boxId	string	Id of the parent expense box.
accountLinkId	string	AccountLink document id.
source	string	manual, bank, or crypto.
paymentMode	string	account or creditCard.
creditCycleEndDay	number	Credit cycle end day 1–31 when paymentMode is creditCard.
payment	object	Primary funding slot (always uses accountId).
credit	object	Optional credit-card slot when paymentMode is creditCard.
alertSettings	object	Box account alert rules (balanceThreshold, insufficientForPlan, creditExceedsPayment).

Request

curl --request GET \
  --url 'https://api.getliquify.com/v1/get_account?budgetId=bud_01&boxId=box_01' \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "data": {
    "budgetId": "bud_01",
    "boxId": "box_01",
    "accountLinkId": "alink_01",
    "source": "manual",
    "paymentMode": "account",
    "payment": {
      "accountId": "acc_01",
      "name": "Cash",
      "currency": "EUR",
      "balance": 250,
      "accountKind": "checking"
    },
    "credit": null,
    "alertSettings": {
      "balanceThreshold": {
        "enabled": true,
        "amount": 100,
        "direction": "below"
      }
    }
  }
}

Query

Response data

Related

Response `data`