---
title: "Get all accounts"
method: GET
path: "/plans/{plan_id}/accounts"
tags: ["Accounts"]
---

# Get all accounts

`GET /plans/{plan_id}/accounts`

Returns all accounts

## Path parameters

- `plan_id` string, required

## Query parameters

- `last_knowledge_of_server` integer

## Response `200`

The list of requested accounts

- AccountsResponse
  - `data` object, required
    - `accounts` Account[], required
      - `id` string, uuid, required
      - `name` string, required
      - `type` 'checking' | 'savings' | 'cash' | 'creditCard' | 'lineOfCredit' | 'otherAsset' | 'otherLiability' | 'mortgage' | 'autoLoan' | 'studentLoan' | 'personalLoan' | 'medicalDebt' | 'otherDebt', required — The type of account
      - `on_budget` boolean, required — Whether this account is "on budget" or not
      - `closed` boolean, required — Whether this account is closed or not
      - `note` string, nullable
      - `balance` integer, required — The current available balance of the account in milliunits format
      - `cleared_balance` integer, required — The current cleared balance of the account in milliunits format
      - `uncleared_balance` integer, required — The current uncleared balance of the account in milliunits format
      - `transfer_payee_id` string, uuid, nullable, required — The payee id which should be used when transferring to this account
      - `direct_import_linked` boolean — Whether or not the account is linked to a financial institution for automatic transaction import.
      - `direct_import_in_error` boolean — If an account linked to a financial institution (direct_import_linked=true) and the linked connection is not in a healthy state, this will be true.
      - `last_reconciled_at` string, date-time, nullable — A date/time specifying when the account was last reconciled.
      - `debt_original_balance` integer, nullable — This field is deprecated and will always be null.
      - `debt_interest_rates` LoanAccountPeriodicValue, nullable
      - `debt_minimum_payments` LoanAccountPeriodicValue, nullable
      - `debt_escrow_amounts` LoanAccountPeriodicValue, nullable
      - `deleted` boolean, required — Whether or not the account has been deleted. Deleted accounts will only be included in delta requests.
      - `balance_formatted` string — The current available balance of the account formatted in the plan's currency format
      - `balance_currency` number, double — The current available balance of the account as a decimal currency amount
      - `cleared_balance_formatted` string — The current cleared balance of the account formatted in the plan's currency format
      - `cleared_balance_currency` number, double — The current cleared balance of the account as a decimal currency amount
      - `uncleared_balance_formatted` string — The current uncleared balance of the account formatted in the plan's currency format
      - `uncleared_balance_currency` number, double — The current uncleared balance of the account as a decimal currency amount
    - `server_knowledge` integer, required — The knowledge of the server

## Other responses

- `404` — No accounts were found

---

[API](https://skmtc.dev/ynab/apis/ynab-api-endpoints.md) · [All operations](https://skmtc.dev/ynab/apis/ynab-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ynab/ynab-api-endpoints/revisions/da7a78345b34/schema)