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.

Get transaction

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

Returns the details of a single transaction on an account.

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
transactionId	string , required	This identification is given by the attribute transactionId of the corresponding entry of a transaction list. Example: `3dc3d5b3-7023-4848-9853-f5400a64e80f` Allowed length: max: 70

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
transactionDetails	object , required	A transaction entry.
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

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/{transactionId}" \
  -H "X-Request-ID: 99391c7e-ad88-49ec-a2ad-99ddcb1f7721" \
  -H "Consent-ID: 123cons456"

{
  "transactionDetails": {
    "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"
      }
    }
  }
}

{
  "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.