Read account details

{
  "type": "object",
  "required": [
    "account"
  ],
  "properties": {
    "account": {
      "type": "object",
      "description": "The ASPSP shall give at least one of the account reference identifiers:\n  - iban\n  - bban\n  - pan\n  - maskedPan\n  - msisdn\nIf the account is a multicurrency account currency code in \"currency\" is set to \"XXX\".\n",
      "required": [
        "currency"
      ],
      "properties": {
        "_links": {
          "type": "object",
          "description": "Links to the account, which can be directly used for retrieving account information from this dedicated account.\n\nLinks to \"balances\" and/or \"transactions\"\n\nThese links are only supported, when the corresponding consent has been already granted.\n",
          "properties": {
            "balances": {
              "type": "object",
              "description": "Link to a resource.",
              "properties": {
                "href": {
                  "type": "string",
                  "description": "Link to a resource."
                }
              }
            },
            "transactions": {
              "type": "object",
              "description": "Link to a resource.",
              "properties": {
                "href": {
                  "type": "string",
                  "description": "Link to a resource."
                }
              }
            }
          }
        },
        "balances": {
          "type": "array",
          "description": "A list of balances regarding this account, e.g. the current balance, the last booked balance.\nThe list might be restricted to the current balance.\n",
          "items": {
            "type": "object",
            "description": "A single balance element.\n",
            "required": [
              "balanceAmount",
              "balanceType"
            ],
            "properties": {
              "balanceAmount": {
                "type": "object",
                "required": [
                  "currency",
                  "amount"
                ],
                "properties": {
                  "amount": {
                    "type": "string",
                    "description": "The amount given with fractional digits, where fractions must be compliant to the currency definition.\nUp to 14 significant figures. Negative amounts are signed by minus.\nThe decimal separator is a dot.\n\n**Example:**\nValid representations for EUR with up to two decimals are:\n\n  * 1056\n  * 5768.2\n  * -1.50\n  * 5877.78\n"
                  },
                  "currency": {
                    "type": "string",
                    "description": "ISO 4217 Alpha 3 currency code.\n"
                  }
                }
              },
              "balanceType": {
                "type": "string",
                "description": "The following balance types are defined:\n  - \"closingBooked\":\n    Balance of the account at the end of the pre-agreed account reporting period.\n    It is the sum of the opening booked balance at the beginning of the period and all entries booked\n    to the account during the pre-agreed account reporting period.\n\n    For card-accounts, this is composed of\n\n      - invoiced, but not yet paid entries\n\n  - \"expected\":\n    Balance composed of booked entries and pending items known at the time of calculation,\n    which projects the end of day balance if everything is booked on the account and no other entry is posted.\n    \n    For card accounts, this is composed of:\n      - invoiced, but not yet paid entries\n      - not yet invoiced but already booked entries and\n      - pending items (not yet booked)\n    \n    For card-accounts:\n\n    \"money to spend with the value of a pre-approved credit limit on the card account\"\n\n  - \"openingBooked\":\n    Book balance of the account at the beginning of the account reporting period.\n    It always equals the closing book balance from the previous report.\n  - \"interimAvailable\":\n    Available balance calculated in the course of the account ?servicer?s business day,\n    at the time specified, and subject to further changes during the business day.\n    The interim balance is calculated on the basis of booked credit and debit items during the calculation\n    time/period specified.\n    \n    For card-accounts, this is composed of:\n      - invoiced, but not yet paid entries\n      - not yet invoiced but already booked entries\n  - \"interimBooked\":\n    Balance calculated in the course of the account servicer's business day, at the time specified,\n    and subject to further changes during the business day.\n    The interim balance is calculated on the basis of booked credit and debit items during the calculation time/period\n    specified.\n  - \"forwardAvailable\":\n    Forward available balance of money that is at the disposal of the account owner on the date specified.\n  - \"nonInvoiced\":\n    Only for card accounts, to be checked yet.\n",
                "enum": [
                  "closingBooked",
                  "expected",
                  "openingBooked",
                  "interimAvailable",
                  "interimBooked",
                  "forwardAvailable",
                  "nonInvoiced"
                ]
              },
              "creditLimitIncluded": {
                "type": "boolean",
                "description": "A flag indicating if the credit limit of the corresponding account\nis included in the calculation of the balance, where applicable.\n"
              },
              "lastChangeDateTime": {
                "type": "string",
                "format": "date-time",
                "description": "This data element might be used to indicate e.g. with the expected or booked balance that no action is known\non the account, which is not yet booked.\n"
              },
              "lastCommittedTransaction": {
                "type": "string",
                "description": "\"entryReference\" of the last commited transaction to support the TPP in identifying whether all\nPSU transactions are already known.\n"
              },
              "referenceDate": {
                "type": "string",
                "format": "date",
                "description": "Indicates the date of the balance."
              }
            }
          }
        },
        "bban": {
          "type": "string",
          "description": "Basic Bank Account Number (BBAN) Identifier.\n\nThis data element can be used in the body of the consent request.\n  Message for retrieving account access consent from this account. This\n  data elements is used for payment accounts which have no IBAN.\n  ISO20022: Basic Bank Account Number (BBAN). \n  \n  Identifier used nationally by financial institutions, i.e., in individual countries, \n  generally as part of a National Account Numbering Scheme(s), \n  which uniquely identifies the account of a customer.\n"
        },
        "bic": {
          "type": "string",
          "description": "BICFI\n"
        },
        "cashAccountType": {
          "type": "string",
          "description": "ExternalCashAccountType1Code from ISO 20022.\n"
        },
        "currency": {
          "type": "string",
          "description": "ISO 4217 Alpha 3 currency code.\n"
        },
        "details": {
          "type": "string",
          "description": "Specifications that might be provided by the ASPSP:\n  - characteristics of the account\n  - characteristics of the relevant card\n"
        },
        "displayName": {
          "type": "string",
          "description": "Name of the account as defined by the PSU within online channels.\n"
        },
        "iban": {
          "type": "string",
          "description": "IBAN of an account."
        },
        "linkedAccounts": {
          "type": "string",
          "description": "Case of a set of pending card transactions, the APSP will provide the relevant cash account the card is set up on."
        },
        "msisdn": {
          "type": "string",
          "description": "Mobile phone number."
        },
        "name": {
          "type": "string",
          "description": "Name of the account, as assigned by the ASPSP, in agreement with the account owner in order to provide an additional means of identification of the account."
        },
        "ownerName": {
          "type": "string",
          "description": "Name of the legal account owner. \nIf there is more than one owner, then e.g. two names might be noted here.\n\nFor a corporate account, the corporate name is used for this attribute.\nEven if supported by the ASPSP, the provision of this field might depend on the fact whether an explicit consent to this specific additional account information has been given by the PSU.\n"
        },
        "product": {
          "type": "string",
          "description": "Product name of the bank for this account, proprietary definition."
        },
        "resourceId": {
          "type": "string",
          "description": "This shall be filled, if addressable resource are created by the ASPSP on the /accounts or /card-accounts endpoint."
        },
        "status": {
          "type": "string",
          "description": "Account status. The value is one of the following:\n  - \"enabled\": account is available\n  - \"deleted\": account is terminated\n  - \"blocked\": account is blocked e.g. for legal reasons\nIf this field is not used, than the account is available in the sense of this specification.\n",
          "enum": [
            "enabled",
            "deleted",
            "blocked"
          ]
        },
        "usage": {
          "type": "string",
          "description": "Specifies the usage of the account:\n  * PRIV: private personal account\n  * ORGA: professional account\n",
          "enum": [
            "PRIV",
            "ORGA"
          ]
        }
      }
    }
  }
}