---
title: "Retrieve the list of bank accounts for a xs2a.api bank user"
method: GET
path: "/api/accounts"
tags: ["XS2A.api.accounts"]
---

# Retrieve the list of bank accounts for a xs2a.api bank user

`GET /api/accounts`

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

Request successfully processed

- BankAccountsList
  - `total` integer — Total number of results.
  - `per_page` integer — Number of objects per page
  - `current_page` integer — Current page.
  - `last_page` integer — Last page, usually the total of available pages.
  - `next_page_url` string, nullable — URI to next page.
  - `prev_page_url` string, nullable — URI to previous page.
  - `from` integer — Showing results from index element.
  - `to` integer — Showing results to index element.
  - `data` BankAccount[]
    - `id` string — Bank Account ID
    - `bank_connection_id` string — Id of the originating BankConnection.
    - `holder` string — Name of the account holder as reported by the bank
    - `iban` string — IBAN of the bank account
    - `description` string — Description of the bank account
    - `bic` string — BIC of the bank account
    - `account_number` string — Number of the account
    - `bank_code` string — bank code of the bank
    - `bank_name` string — name of the bank
    - `country_id` 'DE' | 'AT' | 'CH' — The 2-letter country code
    - `type` 'giro' | 'creditcard' | 'savings' | 'loan' | 'securities' | 'wallet' | 'other' — The type of the bank of the bank connection
    - `joint_account` boolean — Indicates whether this account has more than one owner.
    - `transaction_possible` string — Indicates whether this account places payments ("1" for true, "0" for false).
    - `created_at` string — Date of creation
    - `object` string — The value bank_account

## Other responses

- `401` — Authentication failed API key missing or not valid
- `403` — Forbidden Access blocked
- `404` — Product not enabled or Not found The requested object does not exist on the server
- `422` — Validation failed Something is wrong with the user input
- `500` — An internal server problem occurred

---

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