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

# Get account

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

## Request

- Base URL: `https://api.nrich.qwist.cloud`
- URL: `https://api.nrich.qwist.cloud/rest/accounts/{account-id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/qwist/apis/finx-api/docs/rest/accounts/:account-id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve detailed information about an account identified by its ID.

## Path parameters

- `account-id` string, required: nrich 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` Bic (unresolved $ref)
  - `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` SEPATransfer (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)

## Changes

- **2026-11-03** `398592d93b1f`: 6 breaking, 11 info
  - the `access_id` response's property type changed from no type to `string` for status `200`
  - the `account_id` response's property type changed from no type to `string` for status `200`
  - the `balance` response's property type changed from no type to `object` for status `200`
  - the `currency` response's property type changed from no type to `string`, and format from no format to `ISO 4217:2015` for status `200`
  - …13 more

[Operation history](https://skmtc.dev/qwist/apis/finx-api/changes/rest/accounts/:account-id/get.md)

---

[API](https://skmtc.dev/qwist/apis/finx-api.md) - [All operations](https://skmtc.dev/qwist/apis/finx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qwist/apis/finx-api/revisions/398592d93b1f?raw)