Skip to main content
GET
/
open-banking
/
v1
/
accounts
Read account list
curl --request GET \
  --url https://api.example.com/open-banking/v1/accounts \
  --header 'Consent-ID: <consent-id>' \
  --header 'X-Request-ID: <x-request-id>'
{
  "accounts": [
    {
      "currency": "EUR",
      "resourceId": "3dc3d5b3-7023-4848-9853-f5400a64e80f",
      "iban": "DE2310010010123456788",
      "bban": "1234567890",
      "msisdn": "+49170123456",
      "ownerName": "Heike Mustermann",
      "ownerNames": [
        {
          "name": "Heike Mustermann",
          "role": "owner"
        }
      ],
      "psuName": "Max Mustermann",
      "name": "Main Account",
      "displayName": "My daily account",
      "product": "Girokonto",
      "cashAccountType": "CACC",
      "status": "enabled",
      "bic": "DEUTDEDBFRA",
      "linkedAccounts": "Savings Account",
      "usage": "PRIV",
      "details": "<string>",
      "balances": [
        {
          "balanceAmount": {
            "currency": "EUR",
            "amount": "123.50"
          },
          "balanceType": "closingBooked",
          "creditLimitIncluded": true,
          "lastChangeDateTime": "2025-11-27T15:30:35.035Z",
          "referenceDate": "2025-11-27",
          "lastCommittedTransaction": "ENT-0001"
        }
      ],
      "_links": {
        "scaRedirect": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "scaOAuth": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "confirmation": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "startAuthorisation": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "startAuthorisationWithPsuIdentification": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "updatePsuIdentification": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "startAuthorisationWithProprietaryData": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "updateProprietaryData": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "startAuthorisationWithPsuAuthentication": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "updatePsuAuthentication": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "updateAdditionalPsuAuthentication": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "startAuthorisationWithEncryptedPsuAuthentication": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "updateEncryptedPsuAuthentication": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "updateAdditionalEncryptedPsuAuthentication": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "startAuthorisationWithAuthenticationMethodSelection": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "selectAuthenticationMethod": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "creditorNameConfirmation": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "self": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "status": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "scaStatus": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "account": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "balances": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "transactions": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "cardAccount": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "cardTransactions": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "transactionDetails": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "first": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "next": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "previous": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "last": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        },
        "download": {
          "href": "/v1/payments/sepa-credit-transfers/1234-payment-567"
        }
      }
    }
  ]
}

Headers

ID of the consent resource

X-Request-ID
string
required

ID of the request, unique to the call, as determined by the initiating party

Query Parameters

withBalance
boolean | null

If contained, this function reads the list of accessible payment accounts including the booking balance

Response

Account list successfully retrieved

accounts
object[]
required

List of available payment accounts

Last modified on April 17, 2026