---
title: "List accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List accounts

`GET /accounts`

List linked financial accounts with current balances and metadata.

## Query parameters

- `hidden` 'true' | 'false'

## Response `200`

Accounts retrieved.

- object
  - `data` object, required
    - `accounts` object[], required
      - `id` string, required
      - `name` string, required
      - `mask` string, nullable, required
      - `type` string, required
      - `subtype` string, nullable, required
      - `balance_available` number, nullable, required
      - `balance_current` number, nullable, required
      - `balance_limit` number, nullable, required
      - `status` string, required
      - `as_of` string, nullable, required
      - `institution_name` string, nullable, required
      - `institution_logo` string, nullable, required
      - `external_source` string, required
      - `next_payment_due_date` string, nullable, required
      - `interest_rate_percentage` number, nullable, required
      - `hidden` boolean, required
      - `apy_percent_display` string, nullable, required
  - `meta` object, required
    - `request_id` string, required
    - `timestamp` string, date-time, required

---

[API](https://skmtc.net/yoshi-ai-dev/apis/yoshi-api.md) · [All operations](https://skmtc.net/yoshi-ai-dev/apis/yoshi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yoshi-ai-dev/yoshi-api/revisions/79b8247d58a2/schema)