list_accounts

Generado

Generado desde el código con python -m docsgen; una prueba falla si deja de coincidir. Las descripciones vienen del código y se mantienen en inglés: es el idioma en que las leen los agentes.

Qué hace

List the plan’s accounts with their current balances (in currency units).

Use it to reconcile YNAB with the bank.

Comportamiento

Tipo	solo lectura
Confirmación	no
Deshacer	no
Idempotente	sí
Peticiones a YNAB	1 para el ejemplo de abajo, con la caché vacía

Parámetros

Nombre	Tipo	Obligatorio	Por defecto	Descripción
plan_id	string	sí	—	YNAB plan id or ‘last-used’.

Devuelve

array of object

Campo	Tipo	Descripción
id	string	YNAB id of the account.
name	string	Account name.
type	string	YNAB account type, e.g. checking, savings, creditCard, otherAsset.
on_budget	boolean	False for a tracking account, whose transactions take no category.
closed	boolean	True when the account is closed in YNAB.
balance	number	Balance of all transactions.
cleared_balance	number	Balance of the transactions the bank has shown.
uncleared_balance	number	Balance of the transactions the bank has not shown yet.

Ejemplo

Argumentos:

{
  "plan_id": "demo-budget"
}

Respuesta sobre el presupuesto de demostración:

[
  {
    "id": "acc-checking",
    "name": "Checking",
    "type": "checking",
    "on_budget": true,
    "closed": false,
    "balance": 3512.66,
    "cleared_balance": 3512.66,
    "uncleared_balance": 0.0
  },
  {
    "id": "acc-savings",
    "name": "Savings",
    "type": "savings",
    "on_budget": true,
    "closed": false,
    "balance": 600.0,
    "cleared_balance": 600.0,
    "uncleared_balance": 0.0
  }
]

Errores

Esta herramienta no lanza errores propios; los errores de YNAB llegan como Error calling tool '<tool>': YNAB <status>: <detail>.