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

# List accounts

`GET /v3/aggregation/accounts`

Return a list of the user's accounts

## Query parameters

- `limit` number
- `item_id` number

## Response `200`

List accounts

- object — Represent paginated collection of resources.
  - `resources` Account[]
    - `id` number — Account's unique identifier
    - `name` string — Account's name taken from the provider's website
    - `balance` number — Account's balance
    - `accounting_balance` number — Accounting balance represents the available money excluding pending and processing transactions
    - `instant_balance` number — Instant balance represents the expected money on the account including pending and processing transactions
    - `updated_at` string, date-time — Timestamp recording when the account was last updated
    - `last_refresh_status` 'failed' | 'successful' — Indicate if the account was updated successfully or not during the last refresh of the item
    - `type` 'checking' | 'savings' | 'brokerage' | 'card' | 'loan' | 'pea' | 'life_insurance' | 'unknown' — Account's type
    - `currency_code` string — 3 letters ISO 4217 currency code
    - `item_id` number — Identifier of the account's item
    - `provider_id` number — Identifier of the account's provider
    - `loan_details` object
      - `next_payment_date` string, date — Date when the next payment is owed
      - `next_payment_amount` number — Amount owed for the next payment
      - `maturity_date` string, date — Predicted end of the loan's refunding
      - `opening_date` string, date — Date when the loan was contracted
      - `interest_rate` number — Loan's interest rate
      - `type` string — Loan type
      - `borrowed_capital` number — Amount of capital that was borrowed
      - `repaid_capital` number — Amount of capital that has already been repaid.
      - `remaining_capital` number — Amount of capital left to repay
    - `pro` boolean — Flag to indicate that the account is a business account
    - `data_access` 'enabled' | 'disabled' — User approved access to this account
    - `iban` string, iban — The IBAN of the bank account
  - `pagination` object
    - `next_uri` string, nullable

## Other responses

- `401` — Error 401

---

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