---
title: "Get account"
method: GET
path: "/rest/accounts/{account-id}"
tags: ["Accounts"]
---

# Get account

`GET /rest/accounts/{account-id}`

Retrieve detailed information about an account identified by its ID.

## Path parameters

- `account-id` string, required — finX ID of account.

## Parameters

- `#/paths/~1rest~1payments/get/parameters/5` — unresolved $ref

## Response `200`

Account details.

- object
  - `account_id` Schema, required — unresolved $ref
  - `account_number` string, required — Domestic account identifier.
  - `bank_code` string, required — Domestic bank code.
  - `iban` Iban — unresolved $ref
  - `bic` string, ISO 9362:2014 — Business Identifier Code (SWIFT-BIC).
  - `access_id` Schema, required — unresolved $ref
  - `bank_name` string, required — Name of bank or financial provider.
  - `icon` object, required
    - `url` string, url — URL to provider icon.
    - `resolutions` object — A mapping of icon resolutions in the format `{res}x{res}` to their respective icon URLs.
      - `48x48` string, url — URL to provider icon in aspect ratio 48x48px.
      - `60x60` string, url — URL to provider icon in aspect ratio 60x60px.
      - `72x72` string, url — URL to provider icon in aspect ratio 72x72px.
      - `84x84` string, url — URL to provider icon in aspect ratio 84x84px.
      - `96x96` string, url — URL to provider icon in aspect ratio 96x96px.
      - `120x120` string, url — URL to provider icon in aspect ratio 120x120px.
      - `144x144` string, url — URL to provider icon in aspect ratio 144x144px.
      - `192x192` string, url — URL to provider icon in aspect ratio 192x192px.
      - `256x256` string, url — URL to provider icon in aspect ratio 256x256px.
    - `required` unknown
  - `currency` Currency, required — unresolved $ref
  - `balance` 0, required — unresolved $ref
  - `type` Items, required — unresolved $ref
  - `name` string, required — Name of the account.
  - `owner` string — Name of the account holder.
  - `auto_sync` boolean, required — Indicates if the account is automatically synchronized.
  - `save_pin` boolean, required — Indicates if the provider credentials are saved for this account.
  - `supported_payments` object, required — Mapping of payment types to payment parameters supported by this account.
    - `SEPA transfer` object
      - `allowed_recipients` string[], required — List of account codes. The payment recipient must be one of these accounts. No restriction applies if this field is omitted.
      - `can_be_recurring` boolean, required — Indicates whether payments of this type can be recurring. This usually applies for standing orders.
      - `can_be_scheduled` boolean, required — Indicates whether payments of this type can be scheduled to be executed on a specific date. This usually applies for standing orders.
      - `max_purpose_length` integer, required — Maximum string length of purpose text.
      - `supported_text_keys` integer[], required — List of supported DTA text keys.
    - `SEPA standing order` SEPA20transfer — unresolved $ref
  - `is_jointly_managed` boolean — Indicates that the account has been opened by two or more individuals or entities.
  - `status` Status, required — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `404` — unresolved $ref
- `4XX` — unresolved $ref

---

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