---
title: "List Accounts for a User"
method: GET
path: "/v1/accounts"
tags: ["Accounts"]
---

# List Accounts for a User

`GET /v1/accounts`

> 📘
>
> You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.

Retrieve all Accounts for a User.

> 📘
>
> This resource returns paginated results in descending order.  For more details please see: [Pagination](https://docs.astra.finance/reference/pagination)

## Query parameters

- `page_size` integer
- `cursor_id` string

## Response `200`

Successful response

- object
  - `count` integer — The number of accounts returned
  - `accounts` object[]
    - `id` string — The unique ID of the Account
    - `status` 'approved' | 'rejected' | 'unreviewed' — The status of the underlying account. Only accounts with a status of approved can be used in routines.
    - `removed` boolean — Value of true if the account has been deleted/removed.
    - `official_name` string — The official name of the Account from the Institution
    - `name` string — The name of the Account from the Institution
    - `nickname` string — The name of the Account defined by the User
    - `mask` string — The last four digits of the Account number
    - `institution_name` string — The name of the Institution where the Account is held
    - `institution_logo` string — The Institution logo in base64 format
    - `type` string — The category of the Account type (ie. depository)
    - `subtype` string — The sub category of the Account type (ie. checking)
    - `current_balance` number, float — The value of the current balance for the Account
    - `available_balance` number, float — The value of the available balance for the Account
    - `last_balance_update_on` unknown
    - `connection_status` string — The current status of the account (connected or error)
  - `next_cursor_id` string — The next cursor ID, for resuming a paginated query
  - `has_next_page` boolean — Whether the paginated query has additional pages (value may be null if no there are no additional pages)

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/astra/apis/astra-developer-api.md) · [All operations](https://skmtc.net/astra/apis/astra-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astra/astra-developer-api/revisions/09f0430e5d33/schema)