Account Information Service (2.3)

The Berlin Group - A European Standards Initiative | info@: info@berlin-group.org | URL: https://www.berlin-group.org/

License: Creative Commons Attribution 4.0 International Public License

Retrieve a PSU's account information — account details, balances, transactions, and statements — for the accounts covered by a valid consent.

List transactions

GET /v2/accounts/{account-id}/transactions

Returns an account's transactions — booked or pending — for the requested period.

Path parameters

Parameter	Type	Description
account-id	string , required	Identifier of the account, returned as `resourceId` in the account list. It stays constant for the account's lifetime. Example: `Text, maximum of 70 characters.` Allowed length: max: 70

Query parameters

Parameter	Type	Description
dateFrom	string , optional	Start date of the transaction list, inclusive. Example: `2020-01-01` Format: date
dateTo	string , optional	End date of the transaction list, inclusive. Defaults to today. Example: `2020-01-01` Format: date
bookingStatus	string , required	Which transactions to return. `booked` is always available; the bank may also support the other values. Values are described in Booking status. Allowed values: booked, pending, both Example: `booked`
withBalance	boolean , optional	Include the account's balances in the response, when the consent and bank allow. Example: `true`

Header parameters

Header	Type	Description
Digest	string , optional	Integrity hash of the request body in the form `SHA-256=<base64>`. For an empty body, use the hash of an empty string. See Signing requests for how the Digest and signature are built. Example: `SHA-256=hl1/Eps8BEQW58FJhDApwJXjGY4nr1ArGDHIT25vq6A=`
x-jws-signature	string , optional	Detached JSON Web Signature over the signed request headers and body. See Signing requests for how it is constructed.
X-Request-ID	string , required	Unique ID of the request, set by the initiating party and echoed back in the response. Example: `99391c7e-ad88-49ec-a2ad-99ddcb1f7721` Format: uuid
PSU-IP-Address	string , optional	IP address of the PSU's device as forwarded by the TPP. If unavailable, use the IP address the TPP used for this request. Example: `192.168.8.78` Format: ipv4
Consent-ID	string , required	Identifier of the consent that authorises this access, as returned when the consent was created. Example: `123cons456` Allowed length: max: 70

Responses

Select a status code to see the structure and an example of the response.

Field	Type	Description
account	object , required	Identifier of the addressed account.
iban	string , required	International Bank Account Number.
balances	array[object] , optional	A list of balances regarding this account, e.g. the current balance, the last booked balance.
balanceType	string , required	The type of balance. Values are described in Balance types. Allowed values: interimAvailable
balanceAmount	object , required	The balance amount and its currency.
amount	string , required	Amount with decimal digits and a dot as the decimal separator. Example: `42.50` Pattern: ^-?[0-9]{1,14}(\.[0-9]{1,3})?$
currency	string , required	ISO 4217 Alpha 3 currency code
transactions	object , optional	The account's transactions, split into booked and pending.
booked	array[object] , optional	Shall be contained if bookingStatus parameter is set to "booked" or "both".
creditor	object , required	Name and, where available, identification of the creditor (on a debit).
name	string , required	Name of the party.
valueDate	string , required	Date the funds became available for a credit, or were taken for a debit. Format: date
transactionId	string , optional	Identifier used to request the details of this transaction.
creditorAccount	object , required	The creditor's account.
iban	string , required	International Bank Account Number.
transactionAmount	object , required	The transaction amount and its currency. Negative for debits.
amount	string , required	Amount with decimal digits and a dot as the decimal separator. Example: `42.50` Pattern: ^-?[0-9]{1,14}(\.[0-9]{1,3})?$
currency	string , required	ISO 4217 Alpha 3 currency code
remittanceInformationUnstructured	array[string] , optional	Free-text remittance information.
_links	object , optional	Link to this transaction's details.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	Link to this resource.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required
pending	array[object] , optional	Not contained if the bookingStatus parameter is set to "booked".
creditor	object , required	Name and, where available, identification of the creditor (on a debit).
name	string , required	Name of the party.
valueDate	string , required	Date the funds became available for a credit, or were taken for a debit. Format: date
transactionId	string , optional	Identifier used to request the details of this transaction.
creditorAccount	object , required	The creditor's account.
iban	string , required	International Bank Account Number.
transactionAmount	object , required	The transaction amount and its currency. Negative for debits.
amount	string , required	Amount with decimal digits and a dot as the decimal separator. Example: `42.50` Pattern: ^-?[0-9]{1,14}(\.[0-9]{1,3})?$
currency	string , required	ISO 4217 Alpha 3 currency code
remittanceInformationUnstructured	array[string] , optional	Free-text remittance information.
_links	object , optional	Link to this transaction's details.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	Link to this resource.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required
_links	object , required	Links to the account, its balances and transactions, and pagination.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	Link to this resource.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required
_links	object , optional	Links to the account, its balances and transactions, and pagination.
download	object , optional	A hyperlink object containing the target URL.
href	string , required

Field	Type	Description
apiClientMessages	array[object] , optional	Errors and warnings describing why the request failed. See Errors for the message format.
code	string , required	Message codes defined for AIS for HTTP Error code 400 (BAD_REQUEST). Allowed values: FORMAT_ERROR, PARAMETER_NOT_CONSISTENT, PARAMETER_NOT_SUPPORTED, SERVICE_INVALID, CONSENT_UNKNOWN, RESOURCE_UNKNOWN, RESOURCE_EXPIRED, RESOURCE_BLOCKED, TIMESTAMP_INVALID, PERIOD_INVALID, SCA_METHOD_UNKNOWN, SCA_INVALID, CONSENT_TYPE_NOT_SUPPORTED, SESSIONS_NOT_SUPPORTED Example: `FORMAT_ERROR`
path	string , optional
text	string , optional	Example: `Text, maximum of 500 characters.` Allowed length: max: 500
category	string , required	Only "ERROR" or "WARNING" permitted
_links	object , optional	Hyperlinks to related resources.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	Link to this resource.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required

Field	Type	Description
apiClientMessages	array[object] , optional	Errors and warnings describing why the request failed. See Errors for the message format.
code	string , required	Message codes defined for AIS for HTTP Error code 401 (UNAUTHORIZED). Allowed values: CERTIFICATE_INVALID, ROLE_INVALID, CERTIFICATE_EXPIRED, CERTIFICATE_BLOCKED, CERTIFICATE_REVOKED, CERTIFICATE_MISSING, CLIENT_INVALID, CLIENT_INCONSISTENT, API_CONTRACT_ID_INVALID, SIGNATURE_INVALID, SIGNATURE_MISSING, PSU_CREDENTIALS_INVALID, CORPORATE_ID_INVALID, CONSENT_INVALID, CONSENT_EXPIRED, TOKEN_UNKNOWN, TOKEN_INVALID, TOKEN_EXPIRED Example: `CERTIFICATE_INVALID`
path	string , optional
text	string , optional	Example: `Text, maximum of 500 characters.` Allowed length: max: 500
category	string , required	Only "ERROR" or "WARNING" permitted
_links	object , optional	Hyperlinks to related resources.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	Link to this resource.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required

Field	Type	Description
apiClientMessages	array[object] , optional	Errors and warnings describing why the request failed. See Errors for the message format.
code	string , required	Message codes defined for AIS for HTTP Error code 403 (FORBIDDEN). Allowed values: SERVICE_BLOCKED, CONSENT_UNKNOWN, RESOURCE_UNKNOWN, RESOURCE_EXPIRED Example: `SERVICE_BLOCKED`
path	string , optional
text	string , optional	Example: `Text, maximum of 500 characters.` Allowed length: max: 500
category	string , required	Only "ERROR" or "WARNING" permitted
_links	object , optional	Hyperlinks to related resources.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	Link to this resource.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required

Field	Type	Description
apiClientMessages	array[object] , optional	Errors and warnings describing why the request failed. See Errors for the message format.
code	string , required	Message codes defined for AIS for HTTP Error code 405 (METHOD NOT ALLOWED). Allowed values: SERVICE_INVALID Example: `SERVICE_INVALID`
path	string , optional
text	string , optional	Example: `Text, maximum of 500 characters.` Allowed length: max: 500
category	string , required	Only "ERROR" or "WARNING" permitted
_links	object , optional	Hyperlinks to related resources.
last	object , optional	Navigation link for paginated account reports.
href	string , required
next	object , optional	Navigation link for paginated account reports.
href	string , required
self	object , optional	Link to this resource.
href	string , required
first	object , optional	Navigation link for paginated account reports.
href	string , required
status	object , optional	A link to retrieve the status of the transaction resource.
href	string , required
account	object , optional	A link to the resource providing the details of one account
href	string , required
balances	object , optional	A link to the resource providing the balance of a dedicated account.
href	string , required
transactions	object , optional	A link to the resource providing the transaction history of a dedicated account.
href	string , required

curl -X GET \
  "https://openfinance.saltedge.com/ria_money_transfer_sandbox/api/v2/accounts/{account-id}/transactions" \
  -H "X-Request-ID: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721" \
  -H "Consent-ID: 123cons456"

{
  "account": {
    "iban": "LT121000011101001000"
  },
  "balances": [
    {
      "balanceType": "interimAvailable",
      "balanceAmount": {
        "amount": "42.50",
        "currency": "EUR"
      }
    }
  ],
  "transactions": {
    "booked": [
      {
        "creditor": {
          "name": "Text, maximum of 140 characters."
        },
        "valueDate": "2026-09-29",
        "transactionId": "string",
        "creditorAccount": {
          "iban": "LT121000011101001000"
        },
        "transactionAmount": {
          "amount": "42.50",
          "currency": "EUR"
        },
        "remittanceInformationUnstructured": [
          "Text, maximum of 140 characters."
        ],
        "_links": {
          "last": {
            "href": "string"
          },
          "next": {
            "href": "string"
          },
          "self": {
            "href": "string"
          },
          "first": {
            "href": "string"
          },
          "status": {
            "href": "string"
          },
          "account": {
            "href": "string"
          },
          "balances": {
            "href": "string"
          },
          "transactions": {
            "href": "string"
          }
        }
      }
    ],
    "pending": [
      {
        "creditor": {
          "name": "Text, maximum of 140 characters."
        },
        "valueDate": "2026-09-29",
        "transactionId": "string",
        "creditorAccount": {
          "iban": "LT121000011101001000"
        },
        "transactionAmount": {
          "amount": "42.50",
          "currency": "EUR"
        },
        "remittanceInformationUnstructured": [
          "Text, maximum of 140 characters."
        ],
        "_links": {
          "last": {
            "href": "string"
          },
          "next": {
            "href": "string"
          },
          "self": {
            "href": "string"
          },
          "first": {
            "href": "string"
          },
          "status": {
            "href": "string"
          },
          "account": {
            "href": "string"
          },
          "balances": {
            "href": "string"
          },
          "transactions": {
            "href": "string"
          }
        }
      }
    ],
    "_links": {
      "last": {
        "href": "string"
      },
      "next": {
        "href": "string"
      },
      "self": {
        "href": "string"
      },
      "first": {
        "href": "string"
      },
      "status": {
        "href": "string"
      },
      "account": {
        "href": "string"
      },
      "balances": {
        "href": "string"
      },
      "transactions": {
        "href": "string"
      }
    }
  },
  "_links": {
    "download": {
      "href": "string"
    }
  }
}

{
  "apiClientMessages": [
    {
      "code": "FORMAT_ERROR",
      "path": "string",
      "text": "Text, maximum of 500 characters.",
      "category": "string"
    }
  ],
  "_links": {
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "first": {
      "href": "string"
    },
    "status": {
      "href": "string"
    },
    "account": {
      "href": "string"
    },
    "balances": {
      "href": "string"
    },
    "transactions": {
      "href": "string"
    }
  }
}

{
  "apiClientMessages": [
    {
      "code": "CERTIFICATE_INVALID",
      "path": "string",
      "text": "Text, maximum of 500 characters.",
      "category": "string"
    }
  ],
  "_links": {
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "first": {
      "href": "string"
    },
    "status": {
      "href": "string"
    },
    "account": {
      "href": "string"
    },
    "balances": {
      "href": "string"
    },
    "transactions": {
      "href": "string"
    }
  }
}

{
  "apiClientMessages": [
    {
      "code": "SERVICE_BLOCKED",
      "path": "string",
      "text": "Text, maximum of 500 characters.",
      "category": "string"
    }
  ],
  "_links": {
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "first": {
      "href": "string"
    },
    "status": {
      "href": "string"
    },
    "account": {
      "href": "string"
    },
    "balances": {
      "href": "string"
    },
    "transactions": {
      "href": "string"
    }
  }
}

{
  "apiClientMessages": [
    {
      "code": "SERVICE_INVALID",
      "path": "string",
      "text": "Text, maximum of 500 characters.",
      "category": "string"
    }
  ],
  "_links": {
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "self": {
      "href": "string"
    },
    "first": {
      "href": "string"
    },
    "status": {
      "href": "string"
    },
    "account": {
      "href": "string"
    },
    "balances": {
      "href": "string"
    },
    "transactions": {
      "href": "string"
    }
  }
}

No response body.