Fetch account details
POST/api/Accounts/GetAccountDetails
Description​
Retrieve detailed information about a specific account: account names, IBANs, beneficiaries, co-beneficiaries and balances.
Request​
- application/json
Body Parameters
ActionLog object
LogInfo object
Validation objectrequiredThe validation parameter, mandatory to all Banking Suite API calls.
The access token for authentication.
The key assigned to the application.
The unique code assigned to the customer.
The unique identifier of the device.
The key used for login.
The token used to refresh the session.
The username for authentication.
The account number.
The type of the account.
Available options:
1 = "Savings"
2 = "TimeDeposit"
3 = "Checking"
4 = "Current"
5 = "JointCredit"
6 = "Amortizing"
7 = "FullyAmortizing"
8 = "Unexpected"
Responses​
- 200
- application/json
- text/json
- text/plain
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- ]
- Array [
- ]
- Array [
- ]
accounts object[]
Possible values: [1, 2, 3, 4, 5, 6, 7, 8]
Description: 1 = "Savings", 2 = "TimeDeposit", 3 = "Checking", 4 = "Current", 5 = "JointCredit", 6 = "Amortizing", 7 = "FullyAmortizing", 8 = "Unexpected"
Possible values: [0, 1, 2, 3]
Description: 0 = "Undefined", 1 = "EUR", 2 = "USD", 3 = "GBP"
Possible values: [1, 2]
Description: 1 = "Plain", 2 = "Payroll"
Possible values: [0, 1, 2, 3, 4, 5]
Description: 0 = "CanNotSeeAccount", 1 = "CanNotSeeBalance", 2 = "OnlyCanSeeBalance", 3 = "CanDebit", 4 = "CanCredit", 5 = "CanDoAnything"
Possible values: [100, 101, 102, 103, 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 421, 422, 423, 424, 426, 428, 429, 431, 451, 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, 511]
Description: 100 = "Continue", 101 = "SwitchingProtocols", 102 = "Processing", 103 = "EarlyHints", 200 = "OK", 201 = "Created", 202 = "Accepted", 203 = "NonAuthoritativeInformation", 204 = "NoContent", 205 = "ResetContent", 206 = "PartialContent", 207 = "MultiStatus", 208 = "AlreadyReported", 226 = "IMUsed", 300 = "Ambiguous", 300 = "Ambiguous", 301 = "Moved", 301 = "Moved", 302 = "Redirect", 302 = "Redirect", 303 = "RedirectMethod", 303 = "RedirectMethod", 304 = "NotModified", 305 = "UseProxy", 306 = "Unused", 307 = "TemporaryRedirect", 307 = "TemporaryRedirect", 308 = "PermanentRedirect", 400 = "BadRequest", 401 = "Unauthorized", 402 = "PaymentRequired", 403 = "Forbidden", 404 = "NotFound", 405 = "MethodNotAllowed", 406 = "NotAcceptable", 407 = "ProxyAuthenticationRequired", 408 = "RequestTimeout", 409 = "Conflict", 410 = "Gone", 411 = "LengthRequired", 412 = "PreconditionFailed", 413 = "RequestEntityTooLarge", 414 = "RequestUriTooLong", 415 = "UnsupportedMediaType", 416 = "RequestedRangeNotSatisfiable", 417 = "ExpectationFailed", 421 = "MisdirectedRequest", 422 = "UnprocessableEntity", 423 = "Locked", 424 = "FailedDependency", 426 = "UpgradeRequired", 428 = "PreconditionRequired", 429 = "TooManyRequests", 431 = "RequestHeaderFieldsTooLarge", 451 = "UnavailableForLegalReasons", 500 = "InternalServerError", 501 = "NotImplemented", 502 = "BadGateway", 503 = "ServiceUnavailable", 504 = "GatewayTimeout", 505 = "HttpVersionNotSupported", 506 = "VariantAlsoNegotiates", 507 = "InsufficientStorage", 508 = "LoopDetected", 510 = "NotExtended", 511 = "NetworkAuthenticationRequired"
loans object[]
Possible values: [1, 2, 3, 4, 5, 6, 7, 8]
Description: 1 = "Savings", 2 = "TimeDeposit", 3 = "Checking", 4 = "Current", 5 = "JointCredit", 6 = "Amortizing", 7 = "FullyAmortizing", 8 = "Unexpected"
Possible values: [0, 1, 2, 3]
Description: 0 = "Undefined", 1 = "EUR", 2 = "USD", 3 = "GBP"
Possible values: [1, 2]
Description: 1 = "Plain", 2 = "Payroll"
Possible values: [0, 1, 2, 3, 4, 5]
Description: 0 = "CanNotSeeAccount", 1 = "CanNotSeeBalance", 2 = "OnlyCanSeeBalance", 3 = "CanDebit", 4 = "CanCredit", 5 = "CanDoAnything"
normalAccountDetails object
balances object
interestRateScales object[]
Possible values: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14]
Description: 0 = "UNKNOWN", 1 = "OK", 2 = "FAIL", 3 = "UNAUTHORIZED", 4 = "PASSWORD_EXPIRED", 5 = "DISABLED", 6 = "BLOCKED", 7 = "TIME_OUT", 8 = "NO_INTERNET", 9 = "INVALID_ACCOUNT", 10 = "REQUIRE_UPDATE", 11 = "SYSTEM_DOWN", 12 = "PENDING_COMMAND", 13 = "PENDING_LOGIN", 14 = "REGISTERED"
timeDepositAccountDetails object
balances object
timeDepositInterestRates object[]
{
"accounts": [
{
"accountNumber": "string",
"accountType": 1,
"accountingBalance": 0,
"alias": "string",
"availableBalance": 0,
"currencyID": "string",
"currencyType": 0,
"iban": "string",
"id": "string",
"productType": 1,
"rights": 0
}
],
"httpStatusCode": 100,
"loans": [
{
"accountNumber": "string",
"accountType": 1,
"accountingBalance": 0,
"alias": "string",
"availableBalance": 0,
"currencyID": "string",
"currencyType": 0,
"iban": "string",
"id": "string",
"productType": 1,
"rights": 0
}
],
"message": "string",
"normalAccountDetails": {
"accountCreationDate": "2025-02-02T06:23:02.648Z",
"accountStatus": "string",
"activity": "string",
"balances": {},
"beneficiaries": [
"string"
],
"interestRateDepositionDate": "2025-02-02T06:23:02.649Z",
"interestRateScales": [
{
"basicInterestRate": 0,
"fromAmount": 0,
"scaleInterestRate": 0,
"toAmount": 0,
"totalInterestRate": 0
}
],
"isActive": true,
"mainBeneficiary": "string",
"overdraftLimit": 0
},
"requiredVersion": 0,
"status": 0,
"timeDepositAccountDetails": {
"accountCreationDate": "2025-02-02T06:23:02.649Z",
"accountStatus": "string",
"activity": "string",
"balances": {},
"beneficiaries": [
"string"
],
"isActive": true,
"linkedAccount": "string",
"linkedAccountCurrency": "string",
"mainBeneficiary": "string",
"timeDepositInterestRates": [
{
"endDate": "2025-02-02T06:23:02.649Z",
"increment": 0,
"interestRate": 0,
"startDate": "2025-02-02T06:23:02.649Z",
"totalInterestRate": 0
}
]
}
}
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- ]
- Array [
- ]
- Array [
- ]
accounts object[]
Possible values: [1, 2, 3, 4, 5, 6, 7, 8]
Description: 1 = "Savings", 2 = "TimeDeposit", 3 = "Checking", 4 = "Current", 5 = "JointCredit", 6 = "Amortizing", 7 = "FullyAmortizing", 8 = "Unexpected"
Possible values: [0, 1, 2, 3]
Description: 0 = "Undefined", 1 = "EUR", 2 = "USD", 3 = "GBP"
Possible values: [1, 2]
Description: 1 = "Plain", 2 = "Payroll"
Possible values: [0, 1, 2, 3, 4, 5]
Description: 0 = "CanNotSeeAccount", 1 = "CanNotSeeBalance", 2 = "OnlyCanSeeBalance", 3 = "CanDebit", 4 = "CanCredit", 5 = "CanDoAnything"
Possible values: [100, 101, 102, 103, 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 421, 422, 423, 424, 426, 428, 429, 431, 451, 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, 511]
Description: 100 = "Continue", 101 = "SwitchingProtocols", 102 = "Processing", 103 = "EarlyHints", 200 = "OK", 201 = "Created", 202 = "Accepted", 203 = "NonAuthoritativeInformation", 204 = "NoContent", 205 = "ResetContent", 206 = "PartialContent", 207 = "MultiStatus", 208 = "AlreadyReported", 226 = "IMUsed", 300 = "Ambiguous", 300 = "Ambiguous", 301 = "Moved", 301 = "Moved", 302 = "Redirect", 302 = "Redirect", 303 = "RedirectMethod", 303 = "RedirectMethod", 304 = "NotModified", 305 = "UseProxy", 306 = "Unused", 307 = "TemporaryRedirect", 307 = "TemporaryRedirect", 308 = "PermanentRedirect", 400 = "BadRequest", 401 = "Unauthorized", 402 = "PaymentRequired", 403 = "Forbidden", 404 = "NotFound", 405 = "MethodNotAllowed", 406 = "NotAcceptable", 407 = "ProxyAuthenticationRequired", 408 = "RequestTimeout", 409 = "Conflict", 410 = "Gone", 411 = "LengthRequired", 412 = "PreconditionFailed", 413 = "RequestEntityTooLarge", 414 = "RequestUriTooLong", 415 = "UnsupportedMediaType", 416 = "RequestedRangeNotSatisfiable", 417 = "ExpectationFailed", 421 = "MisdirectedRequest", 422 = "UnprocessableEntity", 423 = "Locked", 424 = "FailedDependency", 426 = "UpgradeRequired", 428 = "PreconditionRequired", 429 = "TooManyRequests", 431 = "RequestHeaderFieldsTooLarge", 451 = "UnavailableForLegalReasons", 500 = "InternalServerError", 501 = "NotImplemented", 502 = "BadGateway", 503 = "ServiceUnavailable", 504 = "GatewayTimeout", 505 = "HttpVersionNotSupported", 506 = "VariantAlsoNegotiates", 507 = "InsufficientStorage", 508 = "LoopDetected", 510 = "NotExtended", 511 = "NetworkAuthenticationRequired"
loans object[]
Possible values: [1, 2, 3, 4, 5, 6, 7, 8]
Description: 1 = "Savings", 2 = "TimeDeposit", 3 = "Checking", 4 = "Current", 5 = "JointCredit", 6 = "Amortizing", 7 = "FullyAmortizing", 8 = "Unexpected"
Possible values: [0, 1, 2, 3]
Description: 0 = "Undefined", 1 = "EUR", 2 = "USD", 3 = "GBP"
Possible values: [1, 2]
Description: 1 = "Plain", 2 = "Payroll"
Possible values: [0, 1, 2, 3, 4, 5]
Description: 0 = "CanNotSeeAccount", 1 = "CanNotSeeBalance", 2 = "OnlyCanSeeBalance", 3 = "CanDebit", 4 = "CanCredit", 5 = "CanDoAnything"
normalAccountDetails object
balances object
interestRateScales object[]
Possible values: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14]
Description: 0 = "UNKNOWN", 1 = "OK", 2 = "FAIL", 3 = "UNAUTHORIZED", 4 = "PASSWORD_EXPIRED", 5 = "DISABLED", 6 = "BLOCKED", 7 = "TIME_OUT", 8 = "NO_INTERNET", 9 = "INVALID_ACCOUNT", 10 = "REQUIRE_UPDATE", 11 = "SYSTEM_DOWN", 12 = "PENDING_COMMAND", 13 = "PENDING_LOGIN", 14 = "REGISTERED"
timeDepositAccountDetails object
balances object
timeDepositInterestRates object[]
{
"accounts": [
{
"accountNumber": "string",
"accountType": 1,
"accountingBalance": 0,
"alias": "string",
"availableBalance": 0,
"currencyID": "string",
"currencyType": 0,
"iban": "string",
"id": "string",
"productType": 1,
"rights": 0
}
],
"httpStatusCode": 100,
"loans": [
{
"accountNumber": "string",
"accountType": 1,
"accountingBalance": 0,
"alias": "string",
"availableBalance": 0,
"currencyID": "string",
"currencyType": 0,
"iban": "string",
"id": "string",
"productType": 1,
"rights": 0
}
],
"message": "string",
"normalAccountDetails": {
"accountCreationDate": "2025-02-02T06:23:02.649Z",
"accountStatus": "string",
"activity": "string",
"balances": {},
"beneficiaries": [
"string"
],
"interestRateDepositionDate": "2025-02-02T06:23:02.649Z",
"interestRateScales": [
{
"basicInterestRate": 0,
"fromAmount": 0,
"scaleInterestRate": 0,
"toAmount": 0,
"totalInterestRate": 0
}
],
"isActive": true,
"mainBeneficiary": "string",
"overdraftLimit": 0
},
"requiredVersion": 0,
"status": 0,
"timeDepositAccountDetails": {
"accountCreationDate": "2025-02-02T06:23:02.649Z",
"accountStatus": "string",
"activity": "string",
"balances": {},
"beneficiaries": [
"string"
],
"isActive": true,
"linkedAccount": "string",
"linkedAccountCurrency": "string",
"mainBeneficiary": "string",
"timeDepositInterestRates": [
{
"endDate": "2025-02-02T06:23:02.649Z",
"increment": 0,
"interestRate": 0,
"startDate": "2025-02-02T06:23:02.649Z",
"totalInterestRate": 0
}
]
}
}
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- ]
- Array [
- ]
- Array [
- ]
accounts object[]
Possible values: [1, 2, 3, 4, 5, 6, 7, 8]
Description: 1 = "Savings", 2 = "TimeDeposit", 3 = "Checking", 4 = "Current", 5 = "JointCredit", 6 = "Amortizing", 7 = "FullyAmortizing", 8 = "Unexpected"
Possible values: [0, 1, 2, 3]
Description: 0 = "Undefined", 1 = "EUR", 2 = "USD", 3 = "GBP"
Possible values: [1, 2]
Description: 1 = "Plain", 2 = "Payroll"
Possible values: [0, 1, 2, 3, 4, 5]
Description: 0 = "CanNotSeeAccount", 1 = "CanNotSeeBalance", 2 = "OnlyCanSeeBalance", 3 = "CanDebit", 4 = "CanCredit", 5 = "CanDoAnything"
Possible values: [100, 101, 102, 103, 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 421, 422, 423, 424, 426, 428, 429, 431, 451, 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, 511]
Description: 100 = "Continue", 101 = "SwitchingProtocols", 102 = "Processing", 103 = "EarlyHints", 200 = "OK", 201 = "Created", 202 = "Accepted", 203 = "NonAuthoritativeInformation", 204 = "NoContent", 205 = "ResetContent", 206 = "PartialContent", 207 = "MultiStatus", 208 = "AlreadyReported", 226 = "IMUsed", 300 = "Ambiguous", 300 = "Ambiguous", 301 = "Moved", 301 = "Moved", 302 = "Redirect", 302 = "Redirect", 303 = "RedirectMethod", 303 = "RedirectMethod", 304 = "NotModified", 305 = "UseProxy", 306 = "Unused", 307 = "TemporaryRedirect", 307 = "TemporaryRedirect", 308 = "PermanentRedirect", 400 = "BadRequest", 401 = "Unauthorized", 402 = "PaymentRequired", 403 = "Forbidden", 404 = "NotFound", 405 = "MethodNotAllowed", 406 = "NotAcceptable", 407 = "ProxyAuthenticationRequired", 408 = "RequestTimeout", 409 = "Conflict", 410 = "Gone", 411 = "LengthRequired", 412 = "PreconditionFailed", 413 = "RequestEntityTooLarge", 414 = "RequestUriTooLong", 415 = "UnsupportedMediaType", 416 = "RequestedRangeNotSatisfiable", 417 = "ExpectationFailed", 421 = "MisdirectedRequest", 422 = "UnprocessableEntity", 423 = "Locked", 424 = "FailedDependency", 426 = "UpgradeRequired", 428 = "PreconditionRequired", 429 = "TooManyRequests", 431 = "RequestHeaderFieldsTooLarge", 451 = "UnavailableForLegalReasons", 500 = "InternalServerError", 501 = "NotImplemented", 502 = "BadGateway", 503 = "ServiceUnavailable", 504 = "GatewayTimeout", 505 = "HttpVersionNotSupported", 506 = "VariantAlsoNegotiates", 507 = "InsufficientStorage", 508 = "LoopDetected", 510 = "NotExtended", 511 = "NetworkAuthenticationRequired"
loans object[]
Possible values: [1, 2, 3, 4, 5, 6, 7, 8]
Description: 1 = "Savings", 2 = "TimeDeposit", 3 = "Checking", 4 = "Current", 5 = "JointCredit", 6 = "Amortizing", 7 = "FullyAmortizing", 8 = "Unexpected"
Possible values: [0, 1, 2, 3]
Description: 0 = "Undefined", 1 = "EUR", 2 = "USD", 3 = "GBP"
Possible values: [1, 2]
Description: 1 = "Plain", 2 = "Payroll"
Possible values: [0, 1, 2, 3, 4, 5]
Description: 0 = "CanNotSeeAccount", 1 = "CanNotSeeBalance", 2 = "OnlyCanSeeBalance", 3 = "CanDebit", 4 = "CanCredit", 5 = "CanDoAnything"
normalAccountDetails object
balances object
interestRateScales object[]
Possible values: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14]
Description: 0 = "UNKNOWN", 1 = "OK", 2 = "FAIL", 3 = "UNAUTHORIZED", 4 = "PASSWORD_EXPIRED", 5 = "DISABLED", 6 = "BLOCKED", 7 = "TIME_OUT", 8 = "NO_INTERNET", 9 = "INVALID_ACCOUNT", 10 = "REQUIRE_UPDATE", 11 = "SYSTEM_DOWN", 12 = "PENDING_COMMAND", 13 = "PENDING_LOGIN", 14 = "REGISTERED"
timeDepositAccountDetails object
balances object
timeDepositInterestRates object[]
{
"accounts": [
{
"accountNumber": "string",
"accountType": 1,
"accountingBalance": 0,
"alias": "string",
"availableBalance": 0,
"currencyID": "string",
"currencyType": 0,
"iban": "string",
"id": "string",
"productType": 1,
"rights": 0
}
],
"httpStatusCode": 100,
"loans": [
{
"accountNumber": "string",
"accountType": 1,
"accountingBalance": 0,
"alias": "string",
"availableBalance": 0,
"currencyID": "string",
"currencyType": 0,
"iban": "string",
"id": "string",
"productType": 1,
"rights": 0
}
],
"message": "string",
"normalAccountDetails": {
"accountCreationDate": "2025-02-02T06:23:02.649Z",
"accountStatus": "string",
"activity": "string",
"balances": {},
"beneficiaries": [
"string"
],
"interestRateDepositionDate": "2025-02-02T06:23:02.649Z",
"interestRateScales": [
{
"basicInterestRate": 0,
"fromAmount": 0,
"scaleInterestRate": 0,
"toAmount": 0,
"totalInterestRate": 0
}
],
"isActive": true,
"mainBeneficiary": "string",
"overdraftLimit": 0
},
"requiredVersion": 0,
"status": 0,
"timeDepositAccountDetails": {
"accountCreationDate": "2025-02-02T06:23:02.649Z",
"accountStatus": "string",
"activity": "string",
"balances": {},
"beneficiaries": [
"string"
],
"isActive": true,
"linkedAccount": "string",
"linkedAccountCurrency": "string",
"mainBeneficiary": "string",
"timeDepositInterestRates": [
{
"endDate": "2025-02-02T06:23:02.649Z",
"increment": 0,
"interestRate": 0,
"startDate": "2025-02-02T06:23:02.649Z",
"totalInterestRate": 0
}
]
}
}