Skip to main content
GET
/
open-banking
/
v1
/
accounts
/
{account-id}
Read account details
curl --request GET \
  --url https://api.example.com/open-banking/v1/accounts/{account-id} \
  --header 'Consent-ID: <consent-id>' \
  --header 'X-Request-ID: <x-request-id>'
{
  "account": {
    "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

Path Parameters

account-id
string
required

Resource identification of the account

Query Parameters

withBalance
boolean | null

If contained, this function reads the account details including the booking balance

Response

Account details successfully retrieved

account
object
required

Account details

Last modified on April 17, 2026