---
title: "Retrieve all accounts for a user without additional data"
method: GET
path: "/accounts-list"
tags: ["accounts"]
---

# Retrieve all accounts for a user without additional data

`GET /accounts-list`

Requires **accounts:read** scope. Optional scope **accounts_details:read** is needed for some extra fields such as account number and sort code. By default this endpoint does not return transaction data (when this isn't returned response times are quicker than the GET /accounts endpoint). Please note: field **additionalBalances** is currently in **beta**

## Query parameters

- `limit` integer
- `offset` integer
- `showTransactionData` boolean
- `showPerformanceScore` boolean
- `connectionId` string

## Response `200`

Successful Accounts Response

- object
  - `data` Account[]
    - `accountName` string, required — The name of the account
    - `currency` string — The currency of the account. It uses the ISO 4217 currency codes.
    - `balance` object, required
      - `amount` object, required
        - `value` integer, required — The value of the balance in minor units of the currency, eg. pennies for GBP.
        - `majorUnits` integer — The major units of the value, based on the values currency, eg. pounds for GBP.
        - `minorUnits` integer — The minor units of the value, based on the values currency, eg. pennies for GBP.
        - `currency` string, required — The currency of the balance taken from the account
      - `date` string, date, required — The date of the balance
      - `type` 'ClosingAvailable' | 'ClosingBooked' | 'ClosingCleared' | 'Expected' | 'ForwardAvailable' | 'Information' | 'InterimAvailable' | 'InterimBooked' | 'InterimCleared' | 'OpeningAvailable' | 'OpeningBooked' | 'OpeningCleared' | 'PreviouslyClosedBooked' — The type of balance as returned by the banking provider. This field is only available for open banking connections. More information can be found [here](https://docs.moneyhubenterprise.com/docs/balance-types)
    - `details` object, required
      - `AER` number — For cash and savings accounts. Interest rate expressed as a percentage 'Annual Equivalent Rate'.
      - `APR` number — For credit cards, mortgages and loans. Interest rate expressed as a percentage 'Annual Percentage Rate'.
      - `sortCodeAccountNumber` string — For cash and saving accounts. Populated with the 6 digit Sort Code and 8 digit Account Number. It requires the `accounts_details:read` scope.
      - `iban` string — For cash and savings accounts. Populated with the full IBAN number. It requires the `accounts_details:read` scope.
      - `pan` string — For card accounts. Populated with the full Primary Account Number of the credit card. It requires the `accounts_details:read` scope.
      - `creditLimit` integer — For credit cards. The agreed overdraft limit of the account in minor units of the currency.
      - `endDate` string, date — For Mortgages and loans. The date at which the loan/mortgage will finish.
      - `fixedDate` string, date — For Mortgages. The date at which the current fixed rate ends
      - `interestFreePeriod` integer — For loans. The length in months of the interest free period
      - `interestType` 'fixed' | 'variable' — For mortgages. The interest type
      - `linkedProperty` string — For Mortgages. The id of an associated property account
      - `monthlyRepayment` integer — For mortgages and loans. The monthly amount due to the mortgage provider in minor units of the currency.
      - `overdraftLimit` integer — For cash accounts. The agreed overdraft limit of the account in minor units of the currency.
      - `postcode` string — For properties. The postcode of the property
      - `runningCost` integer — For assets. The running cost in minor units of the currency.
      - `runningCostPeriod` 'month' | 'year' — For assets. The running cost period
      - `term` integer — For mortgages. The term of the mortgage in months.
      - `yearlyAppreciation` number — For assets. The rate of appreciation as a percentage, negative values indicate that the asset will depreciate
    - `transactionData` object
      - `count` integer, required
      - `earliestDate` string, date-time, required
      - `lastDate` string, date-time, required
    - `dateAdded` string, date-time, required — The date at which the account was added.
    - `dateModified` string, date-time, required — The date at which the account was last modified
    - `id` string, required — The unique identity of the account.
    - `providerName` string — The name of the provider of the account.
    - `providerReference` string — Reference that uniquely identifies a set of connections as being part of the same institution (e.g. HSBC Open banking and HSBC credit cards). It is used to group a set of connections by the banking institution they refer to. It can also be used to retrieve the bank icon.
    - `connectionId` string — The id of the connection of the account. This value is not present for accounts created manually by the user.
    - `providerId` string — The id of the provider of the account. Accounts created using the api have a value of 'API'. Accounts crated for a Test user have a value of 'DEMO'. This value is not present for accounts created manually by the user.
    - `providerAccountId` string — The id of the account given by the provider. This can be used to uniquely identify accounts across different connections.
    - `providerParentAccountId` string — The id of the parent account given by the provider. This can be used to uniquely identify accounts across different connections. Only supports Monzo pots currently
    - `providerAccountName` string — The name of the account given by the provider. Allows to keep track of the provider's name if the account name has been manually updated
    - `accountReference` string — A reference number for the account which consists of the last 4 digits of the account identification number (Account Number, IBAN or PAN). It requires the `accounts_details:read` scope
    - `accountHolderName` string — Account Holder name. It requires the `accounts_details:read` scope.
    - `accountOpeningDate` string, date-time — The date the account was opened as reported by the account provider.
    - `accountType` 'personal' | 'business' — The type of account (personal/business)
    - `productName` string — The name of the product sold / provided from the account provider.
    - `providerAccountIdentifications` object[] — List of specific account identifications when there is no sort code/account number, iban or pan available.
      - `identification` string, required — The account identification
      - `type` string, required — The type of account identification
    - `type` 'cash:current' | 'savings' | 'card' | 'investment' | 'loan' | 'mortgage:repayment' | 'mortgage:interestOnly' | 'pension' | 'pension:definedBenefit' | 'pension:definedContribution' | 'asset' | 'properties:residential' | 'properties:buyToLet' | 'crypto', required — The type of account - this will determine the data available in the details field
    - `performanceScore` object — Performance score of investment and pension accounts. Once that an account has at least 3 balances the score will be provided. Please note that this is an experimental feature.
      - `totals` object, required
        - `openingBalance` object
          - `date` string, date
          - `amount` object
            - `value` integer, required — The opening balance in minor units of the currency, eg. pennies for GBP
            - `majorUnits` integer — The major units of the value, based on the values currency, eg. pounds for GBP.
            - `minorUnits` integer — The minor units of the value, based on the values currency, eg. pennies for GBP.
            - `currency` string, required
        - `currentBalance` object
          - `date` string, date
          - `amount` object
            - `value` integer, required — The current balance in minor units of the currency, eg. pennies for GBP
            - `majorUnits` integer — The major units of the value, based on the values currency, eg. pounds for GBP.
            - `minorUnits` integer — The minor units of the value, based on the values currency, eg. pennies for GBP.
            - `currency` string, required
        - `contributions` integer — The contributions in minor units of the currency, eg. pennies for GBP
        - `withdrawals` integer — The withdrawals in minor units of the currency, eg. pennies for GBP
        - `nonContributionGrowth` integer — The non contribution growth in minor units of the currency, eg. pennies for GBP
        - `growthRate` number — The growth rate expressed in percentage
        - `annualisedGrowthRate` number — The annualised growth rate expressed in percentage
      - `months` object[], required
        - `date` string — Date in the format YYYY-MM
        - `openingBalance` integer — The opening balance in minor units of the currency, eg. pennies for GBP
        - `nonContributionGrowth` integer — The non contribution growth in minor units of the currency, eg. pennies for GBP
        - `aer` number — The aer expressed in percentage
    - `additionalBalances` object[] — (BETA) Additional balance types for the account. The balances will be the latest for each type retrieved from the bank. Will only appear for cash:current, card and savings account types. Please note not all banking providers will return additional balance types, and the types returned will vary. It is recommended to fall back to the main account balance in this case.
      - `amount` object, required
        - `value` integer, required — The value of the balance in minor units of the currency, eg. pennies for GBP.
        - `majorUnits` integer — The major units of the value, based on the values currency, eg. pounds for GBP.
        - `minorUnits` integer — The minor units of the value, based on the values currency, eg. pennies for GBP.
        - `currency` string, required — The currency of the balance taken from the account
      - `date` string, date, required — The date of the balance
      - `type` 'ClosingAvailable' | 'ClosingBooked' | 'ClosingCleared' | 'Expected' | 'ForwardAvailable' | 'Information' | 'InterimAvailable' | 'InterimBooked' | 'InterimCleared' | 'OpeningAvailable' | 'OpeningBooked' | 'OpeningCleared' | 'PreviouslyClosedBooked' — The type of balance as returned by the banking provider. This field is only available for open banking connections. More information can be found [here](https://docs.moneyhubenterprise.com/docs/balance-types)
  - `links` Links
    - `next` string, uri — The url to retrieve the next page of results from
    - `prev` string, uri — The url to retrieve the previous page of results from
    - `self` string, uri, required — The url of the current resource(s)
  - `meta` object

## Other responses

- `401` — Unsuccessful Response - Not authorised - Missing authorization header - Invalid access Token
- `403` — Unsuccessful Response - Forbidden - Invalid scopes

---

[API](https://skmtc.net/moneyhub/apis/moneyhub-data-api.md) · [All operations](https://skmtc.net/moneyhub/apis/moneyhub-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneyhub/moneyhub-data-api/versions/f2eb965eb9af/schema)