Gets account details based on an account identifier.
OAuth Grant type, Private JWT
Client ID header.
Device information permitted for the data query.
You can use this parameter to apply an experience base to optimize data collection.
Identifier of the account. The number format is defined in the "account_id_type" parameter.
Account id country
Account id type
Data structure showing account details.
{
"accountDetails": {
"displayNumber": "*0022",
"nickName": "My eMoney Account",
"baseCurrency": "GBP",
"status": "Open",
"accountIdentifiersList": [
{
"accountIdType": "uuid",
"accountId": "0589bd6c-cca4-4b46-9c8a-b786171e66e1"
},
{
"accountIdType": "iban",
"accountId": "GB40PNXT09991100000023",
"country": "GB"
},
{
"accountIdType": "bban",
"accountId": "PNXT09991100000023",
"country": "GB"
}
],
"customer": {
"customerId": "PNXTGB2LXXXUS1234567890",
"segmentCode": "sme",
"customerName": "Customer Company Name"
},
"productId": "42dbdc87-a491-4566-bb97-eb2d9aea4707",
"virtualAccountStructureId": "42dbdc87-a491-4566-bb97-eb2d9aea4707",
"productName": "eMoney Account",
"accounting": {
"accountingId": "client_account",
"accountingName": "Client Account"
},
"legalEntity": {
"bic": "PNXTGB2LXXX",
"legalEntityId": "pagonxt_uk",
"legalEntityName": "PagoNxt OneTrade UK Ltd"
},
"balances": {
"current": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"consolidated": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"pendingConsolidation": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"withholding": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"overdraft": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"limit": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"available": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
}
},
"openingDateTime": "2017-07-21T17:32:28.000Z",
"lastUpdateDateTime": "2017-07-21T17:32:28.000Z",
"closingDateTime": "2017-07-21T17:32:28.000Z",
"additionalInfo": {},
"limits": [
{
"limitId": "0992c25b-b876-4e8e-a89e-5f22673ca11a",
"limitCurrency": "EUR",
"limitAmount": "100",
"limitType": "balance_limit"
}
]
},
"transactionsListLink": "/accounts/e0c38c29-cdc1-4c61-9c14-a877b72cf549/transactions?account_id_type=uuid",
"accountDetailsLink": "/accounts/e0c38c29-cdc1-4c61-9c14-a877b72cf549?account_id_type=uuid"
}{
"accountDetails": {
"displayNumber": "*0022",
"nickName": "My eMoney Account",
"baseCurrency": "GBP",
"status": "Open",
"accountIdentifiersList": [
{
"accountIdType": "uuid",
"accountId": "0589bd6c-cca4-4b46-9c8a-b786171e66e1"
},
{
"accountIdType": "iban",
"accountId": "GB40PNXT09991100000023",
"country": "GB"
},
{
"accountIdType": "bban",
"accountId": "PNXT09991100000023",
"country": "GB"
}
],
"customer": {
"customerId": "PNXTGB2LXXXUS1234567890",
"segmentCode": "sme",
"customerName": "Customer Company Name"
},
"productId": "42dbdc87-a491-4566-bb97-eb2d9aea4707",
"virtualAccountStructureId": "42dbdc87-a491-4566-bb97-eb2d9aea4707",
"productName": "eMoney Account",
"accounting": {
"accountingId": "client_account",
"accountingName": "Client Account"
},
"legalEntity": {
"bic": "PNXTGB2LXXX",
"legalEntityId": "pagonxt_uk",
"legalEntityName": "PagoNxt OneTrade UK Ltd"
},
"balances": {
"current": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"consolidated": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"pendingConsolidation": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"withholding": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"overdraft": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"limit": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"available": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
},
"realAccountAvailable": {
"amount": {
"amount": "99.99",
"currency": "GBP"
},
"lastChangeDateTime": "2017-07-21T17:32:28.000Z"
}
},
"realAccountIdentifiersList": [
{
"realAccountIdType": "uuid",
"realAccountId": "0589bd6c-cca4-4b46-9c8a-b786171e66e1"
},
{
"realAccountIdType": "iban",
"realAccountId": "GB40PNXT09991100000022",
"country": "GB"
},
{
"realAccountIdType": "bban",
"realAccountId": "PNXT09991100000022",
"country": "GB"
}
],
"openingDateTime": "2017-07-21T17:32:28.000Z",
"lastUpdateDateTime": "2017-07-21T17:32:28.000Z",
"closingDateTime": "2017-07-21T17:32:28.000Z",
"additionalInfo": {},
"limits": [
{
"limitId": "0992c25b-b876-4e8e-a89e-5f22673ca11a",
"limitCurrency": "EUR",
"limitAmount": "100",
"limitType": "balance_limit"
}
]
},
"transactionsListLink": "/accounts/e0c38c29-cdc1-4c61-9c14-a877b72cf549/transactions?account_id_type=uuid",
"accountDetailsLink": "/accounts/e0c38c29-cdc1-4c61-9c14-a877b72cf549?account_id_type=uuid"
}Data structure showing all account details.
Data structure containing account details.
Account number to be displayed. The entire account number is not displayed for privacy reasons.
NickName account Name (alias) that the customer has assigned to the account for easy identification. Applies only when the operation is used by a physical or business customer, not when used by Santander staff.
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Account status. The possible values are:
- Open = Account is open and movements are restricted only by the customers available balance and account contract attributes.
- Blocked by customer= The account is open but is blocked for credit, blocked for debit, or both, ONLY if this block was set by customer itself. In case it is blocked by other distinct to customer, the status will be Blocked.
- Blocked = Account has some restrictive block.
- Closed = Account is closed.
List of account Identifiers.
Identifier of an account. It is usually used to identify the real account related to a virtual account.
Format used for the account number in the accountId property.
The possible values are:
- IBAN = IBAN code
- BBAN = Basic Bank Account Number (BBAN) that represents a country-specific bank account number. Each country has its own standards for the format and length of the BBAN. The value is at most 31 char or 35 bytes long.
- UUID = Unique account identifier. It is an internal code to uniquely identify the account. Some accounts are internal so they have UUID but no IBAN/BBAN.
For example:
- In UK, the BBAN format is: Bank(4) + Sort code(6) + Account(8)
- In Spain, it is: Banco(4) + Sucursal(4) + CD(2) + CTA(10)
Identifier of an account.
Data structure containing details of the country for the account. Country code. The value is based on the ISO 3166-1 alpha-2 (https://www.iso.org/obp/ui/#search/code/).
Customer associated with an account.
Customer identifier of the customer whose accounts are to be included in the response. Applies only when Santander staff wants to access data on the customer's behalf.
Segment code (classification) in which the bank has categorized the customer. Possible values (sme, corp, mnc, bank, emi, api, regulated_corp, lc, fi, nbfi).
Customer Name associated with the account
UUID identification type
UUID identification type
Name of the product associated with the account
Data structure that represent an account type.
Accounting Identification of the customer account.
Accounting Name of the customer account.
Legal Entity details object.
Bic of the LegalEntity
Unique Identifier of the legal entity associated with the account
Legal Name of the legal entity associated with the account
Data structure containing information related to different balances.
Base Balance and date of last change
Amount. The value uses the data format defined in ISO 20022 and has a maximum of 18 digits, of which 5 can be decimals, separated by a point.
Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.
Separation is a point.
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Balance last update date time.
The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Base Balance and date of last change
Amount. The value uses the data format defined in ISO 20022 and has a maximum of 18 digits, of which 5 can be decimals, separated by a point.
Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.
Separation is a point.
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Balance last update date time.
The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Base Balance and date of last change
Amount. The value uses the data format defined in ISO 20022 and has a maximum of 18 digits, of which 5 can be decimals, separated by a point.
Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.
Separation is a point.
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Balance last update date time.
The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Base Balance and date of last change
Amount. The value uses the data format defined in ISO 20022 and has a maximum of 18 digits, of which 5 can be decimals, separated by a point.
Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.
Separation is a point.
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Balance last update date time.
The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Base Balance and date of last change
Amount. The value uses the data format defined in ISO 20022 and has a maximum of 18 digits, of which 5 can be decimals, separated by a point.
Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.
Separation is a point.
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Balance last update date time.
The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Base Balance and date of last change
Amount. The value uses the data format defined in ISO 20022 and has a maximum of 18 digits, of which 5 can be decimals, separated by a point.
Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.
Separation is a point.
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Balance last update date time.
The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Base Balance and date of last change
Amount. The value uses the data format defined in ISO 20022 and has a maximum of 18 digits, of which 5 can be decimals, separated by a point.
Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.
Separation is a point.
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Balance last update date time.
The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Base Balance and date of last change
Amount. The value uses the data format defined in ISO 20022 and has a maximum of 18 digits, of which 5 can be decimals, separated by a point.
Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.
Separation is a point.
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Balance last update date time.
The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
List of real account Identifiers.
Identifier of a real account. It is usually used to identify the real account related to a virtual account.
Account identifier
Format used for the account number in the accountId property.
The possible values are:
- IBAN = IBAN code
- BBAN = Basic Bank Account Number (BBAN) that represents a country-specific bank account number. Each country has its own standards for the format and length of the BBAN. The value is at most 31 char or 35 bytes long.
- UUID = Unique account identifier. It is an internal code to uniquely identify the account. Some accounts are internal so they have UUID but no IBAN/BBAN.
For example:
- In UK, the BBAN format is: Bank(4) + Sort code(6) + Account(8)
- In Spain, it is: Banco(4) + Sucursal(4) + CD(2) + CTA(10)
Data structure containing details of the country for the account. Country code. The value is based on the ISO 3166-1 alpha-2 (https://www.iso.org/obp/ui/#search/code/).
Balance last update date time. The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Last update date of the Account. The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Date when the Account was closed. The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'
Free JSON object.
Data structure that represents all limits that an account has.
Response that retrieves all the limits based on specific filters.
UUID identification type
Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).
Limit amount.
Indicates the type of limit.
Link to the account transactions list.
Link to the account details.
No content
Bad Request
{
"errors": [
{
"code": "INVALID_SCHEMA",
"message": "Invalid input.",
"level": "ERROR",
"description": "Error validating schema."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Unauthorized
{
"errors": [
{
"code": "UNAUTHORIZED",
"message": "A token must be provided.",
"level": "ERROR",
"description": "There was an error during token verification in header [authorization]"
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Forbidden
{
"errors": [
{
"code": "OPERATION_NOT_ALLOWED",
"message": "operation not allowed due to lack of permissions.",
"level": "ERROR",
"description": "Operation not allowed due to lack of permissions."
}
]
}{
"errors": [
{
"code": "INVALID_AUTH_TOKEN",
"message": "The token provided is invalid.",
"level": "ERROR",
"description": "Invalid auth token."
}
]
}{
"errors": [
{
"code": "FORBIDDEN",
"message": "A token must be provided.",
"level": "ERROR",
"description": "Operation not allowed due to lack of permissions."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Data structure showing an account does not exist in the system.
{
"errors": [
{
"code": "NOT_FOUND",
"level": "ERROR",
"message": "Not found.",
"description": "The server can not find the requested resource. In the browser, this means the URL is not recognized."
}
]
}{
"errors": [
{
"code": "ACCOUNT_NOT_FOUND",
"level": "ERROR",
"message": "Account not found.",
"description": "The data related to the account with identifier \"a26c7fc3-3f9b-4045-a946-24e565bee1f9\" could not be found."
}
]
}{
"errors": [
{
"code": "REAL_ACCOUNT_VIRTUAL_STRUCTURE_NOT_EXIST",
"level": "ERROR",
"message": "Real account has no virtual account structure",
"description": "This account with an UUID \"698b21e5-016f-487c-b0a7-bb86772f126f\" has no virtual structure ID."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Method Not Allowed
{
"errors": [
{
"code": "METHOD_NOT_ALLOWED",
"level": "ERROR",
"message": "Method not allowed",
"description": "The request method is known by the server but is not supported by the target resource."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Not Acceptable
{
"errors": [
{
"code": "NOT_ACCEPTABLE",
"level": "ERROR",
"message": "Not Acceptable",
"description": "This response is sent when the web server, after performing server-driven content negotiation, doesn't find any content that conforms to the criteria given by the user agent."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Conflict
{
"errors": [
{
"code": "CONFLICT",
"level": "ERROR",
"message": "Conflict",
"description": "This response is sent when a request conflicts with the current state of the server."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Payload too large
{
"errors": [
{
"code": "PAYLOAD_TOO_LARGE",
"level": "ERROR",
"message": "Payload too large",
"description": "Request entity is larger than limits defined by server. The server might close the connection or return an Retry-After header field."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Request URI Too Long
{
"errors": [
{
"code": "URI_TOO_LARGE",
"level": "ERROR",
"message": "URI too large",
"description": "The URI requested by the client is longer than the server is willing to interpret."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Unsupported Media Type
{
"errors": [
{
"code": "UNSUPPORTED_MEDIA_TYPE",
"level": "ERROR",
"message": "Unsupported Media Type",
"description": "The media format of the requested data is not supported by the server, so the server is rejecting the request."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Unprocessable Entity
{
"errors": [
{
"code": "UNPROCESSABLE_ENTITY",
"level": "ERROR",
"message": "Unprocessable entity.",
"description": "The request was well-formed but was unable to be followed due to semantic errors."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Too Many Requests
{
"errors": [
{
"code": "TOO_MANY_REQUESTS",
"level": "ERROR",
"message": "Too many requests.",
"description": "The user has sent too many requests in a given amount of time"
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Internal Server Error
{
"errors": [
{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error.",
"level": "ERROR",
"description": "INTERNAL_SERVER_ERROR"
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Service Down Error
{
"errors": [
{
"code": "SERVICE_DOWN_ERROR",
"message": "Service down error.",
"level": "ERROR",
"description": "Service down error."
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Gateway Timeout Error
{
"errors": [
{
"code": "GATEWAY_TIMEOUT_ERROR",
"message": "Gateway timeout error.",
"level": "ERROR",
"description": "Gateway timeout error"
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.
Internal Server Error
{
"errors": [
{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error.",
"level": "ERROR",
"description": "INTERNAL_SERVER_ERROR"
}
]
}Data structure containing the details for errors.
Array of errors.
Data structure containing error details.
Unique alphanumeric human readable error code.
Brief summary of the reported issue.
Level of the reported issue. The possible values are:
- ERROR
- FATAL
- INFO
- WARNING
Detailed description of the reported issue.