Retrieves the eMoney accounts list of PagoNXT.

Prev Next
Get
/accounts/{account_id}/virtual-accounts

Retrieves the virtual accounts of a given client account identifier.

The real account identifier can be UUID, IBAN or BBAN specifying a country.

Security
OAuth

OAuth Grant type, Private JWT

FlowClient Credentials
Token URL$(host)/oauth/token
Scopes:
accounts.readRetrieving account information
Header parameters
x-client-id
stringRequired

Client ID header.

Min length36
Max length36
Pattern^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
x-device
string

Device information permitted for the data query.

You can use this parameter to apply an experience base to optimize data collection.

Min length0
Max length255
Pattern^[a-zA-Z]*$
Path parameters
account_id
Required

Identifier of the account. The number format is defined in the "account_id_type" parameter.

ExampleES8299999999530000000097
Query parameters
account_id_country
string

Account id country

Min length2
Max length2
Pattern^[A-Z]*$
ExampleGB
account_id_type
string

Account id type

Valid values[ "iban", "bban", "uuid" ]
Exampleiban
accounting_id_list
string

List of account type identifiers.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleclient_account,virtual_account
accounting_name
string

Name of the accounting id type.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleClient Account, Virtual Account, Virtual Account Limited
additional_info
string

Additional Account Info

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampledocs.file
customer_id
string

Customer identifier.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Examplepagofx_ukGBDTT667794
customer_name
string

Customer name associated with the account.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleCustomer Company Name
currency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
from_available_balance
string

Minimum monetary balance value required for the account to be included in the response. Both negative and positive values are allowed.

Min length1
Max length10
Pattern^[0-9]*$
Example0
from_created_at
string (date-time)

Start date for the time period from which accounts are to be retrieved.

The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'

Example2019-03-14T01:43:19.060Z
from_last_transaction
string (date-time)

Start date for the time period from which accounts are to be retrieved, based on the date when the last transaction have been done.The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'

Example2019-03-14T01:43:19.060Z
historical
boolean

Whether closed accounts are included in the response.

The possible values are:

  • true = Accounts with closed status are included
  • false = Accounts with closed status are not included

The default value is false. If the 'status' parameter is provided, this parameter must not be used.

ExampleFalse
legal_entity_name
string

Legal Name of the legal entity associated with the account.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExamplePagoNxt OneTrade UK Ltd
legal_entity_short_code_list
string

Short code list of the legal entities associated with the account.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Examplepagofx_uk,pagonxt_es
nickname
string

Alias of an account that the customer has assigned to the account for easy identification.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleTest nickname
product_id_list
string

Unique identifiers of products associated with an account.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Example42dbdc87-a491-4566-bb97-eb2d9aea4707,2fb17fee-5f47-4bb5-b179-14e0800beceb
product_name
string

Name of the product associated with the account.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleeMoney Account
status
string

Status of the accounts to be included in the response. The possible values are a comma separated list of:

  • Open = Account is open and movements are restricted only by the customers available balance and account contract attributes. This includes accounts with warnings.
  • Blocked = Account has some restrictive block.
  • Closed = Account is closed.
Valid values[ "Open", "Closed", "Blocked" ]
ExampleOpen
to_available_balance
string

Maximum monetary balance value required for the account to be included in the response. Both negative and positive values are allowed.

Min length1
Max length10
Pattern^[0-9]*$
Example0
to_created_at
string (date-time)

End date for the time period from which accounts are to be retrieved.

The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'

Example2019-03-14T01:43:19.060Z
to_last_transaction
string (date-time)

End date for the time period from which accounts are to be retrieved, based on the date when the last transactions have been done.The date format is 'yyyy-MM-ddThh:mm:ss.fff±timezone', where fff are milliseconds and timezone can be 'Z' or 'hh:mm'

Example2019-03-14T01:43:19.060Z
virtual_account_id_country
string

Virtual account id country

Min length2
Max length2
Pattern^[A-Z]*$
ExampleGB
virtual_account_id_type
string

Virtual account id type

Valid values[ "iban", "bban", "uuid" ]
Exampleiban
virtual_account_structure_id
string

Identifier of an specific virtual account structure

Min length36
Max length36
Pattern^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
Example2507b89c-b680-46df-9505-e0b6f78cf295
virtual_accounts_list
string

List of virtual accounts to be included in the response. The accounts must be defined with comma-separated account numbers without blank spaces. All accounts must be identified using the account number format defined in the 'virtual_account_id_type' parameter. The maximum number of included accounts is 20. If you want data about more than 20 accounts, call the API multiple times, for 20 accounts at a time.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@,/#&+-_ '""]*$
ExamplevirtualAccount1,virtualAccount2,virtualAccount3,virtualAccount4
_expand
string

Query param (string, splitted by comma) that determine how many information we should return. Possible values for this query are:

  • balances
  • status

If the value is 'balances', the response includes the following balance types:

  • consolidated
  • pendingConsolidation
  • withholding
  • overdraft
  • limit
  • available
  • current

The default value is empty and returns no balances.

If the value is 'status', the response includes the following status expanded types:

  • Open
  • Blocked-DR
  • Blocked-CR
  • Blocked-DR&CR
  • Closed

The default value is empty and returns (by default) the following values:

  • Open
  • Blocked
  • Closed
Min length1
Max length255
Pattern^[a-zA-Z_0-9_@,/#&+-_ '""]*$
Examplebalances
_limit
number (integer)

Number of values that should be informed per page.

Minimum1
Maximum1000
Example50
_offset
number (integer)

Pagination identifier.

Minimum1
Maximum1000
Example2
_sort
string

Sorting order for the retrieved accounts.

The possible values are:

  • +product_name = ascending by product_name
  • -product_name = descending by product_name
  • +customer_name = ascending by customer_name
  • -customer_name = descending by customer_name
  • +opening_date_time = ascending by opening_date_time
  • -opening_date_time = descending by opening_date_time
  • +last_update_date_time = ascending by last_update_date_time
  • -last_update_date_time = descending by last_update_date_time
  • +closing_date_time = ascending by closing_date_time
  • -closing_date_time = descending by closing_date_time

If the value is omitted, the default value is '-opening_date_time'.

Valid values[ "-product_name", "+product_name", "-customer_name", "+customer_name", "-opening_date_time", "+opening_date_time", "-last_update_date_time", "+last_update_date_time", "-closing_date_time", "+closing_date_time" ]
Example-opening_date_time
Responses
200

Data structure showing virtual account list details.

VIRTUAL_ACCOUNTS_RESPONSE
{
  "accountsList": [
    {
      "accountDetails": {
        "displayNumber": "*0022",
        "nickName": "My eMoney Account",
        "baseCurrency": "GBP",
        "status": "Open",
        "accountIdentifiersList": [
          {
            "accountIdType": "uuid",
            "accountId": "0589bd6c-cca4-4b46-9c8a-b786171e66e1"
          },
          {
            "accountIdType": "iban",
            "accountId": "GB40PNXT09991100000022",
            "country": "GB"
          },
          {
            "accountIdType": "bban",
            "accountId": "PNXT09991100000022",
            "country": "GB"
          }
        ],
        "customer": {
          "customerId": "PNXTGB2LXXXUS1234567890",
          "segmentCode": "sme",
          "customerName": "Customer Company Name"
        },
        "productId": "42dbdc87-a491-4566-bb97-eb2d9aea4707",
        "productName": "eMoney Account",
        "accounting": {
          "accountingId": "virtual_account",
          "accountingName": "Virtual Account"
        },
        "realAccountIdentifiersList": [
          {
            "realAccountIdType": "uuid",
            "realAccountId": "74382f61-2410-4169-9ddc-ef8f892b3504"
          },
          {
            "realAccountIdType": "iban",
            "realAccountId": "GB20PAGO09197400000026"
          },
          {
            "realAccountIdType": "bban",
            "realAccountId": "9197400000026",
            "country": "GB"
          }
        ],
        "legalEntity": {
          "bic": "PNXTGB2LXXX",
          "legalEntityId": "pagonxt_uk",
          "legalEntityName": "PagoNxt OneTrade UK Ltd"
        },
        "openingDateTime": "2021-07-21T17:32:28.000Z",
        "lastUpdateDateTime": "2021-07-21T17:32:28.000Z",
        "closingDateTime": "2021-07-21T17:32:28.000Z",
        "additionalInfo": {}
      },
      "accountDetailsLink": "/accounts/0589bd6c-cca4-4b46-9c8a-b786171e66e1?account_id_type=uuid",
      "transactionsListLink": "/accounts/0589bd6c-cca4-4b46-9c8a-b786171e66e1/transactions?account_id_type=uuid"
    }
  ],
  "_links": {
    "_first": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504/virtual-accounts?_offset=0&_limit=10&_sort=-opening_date_time",
    "_prev": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504/virtual-accounts?_offset=10&_limit=10&_sort=-opening_date_time",
    "_next": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504/virtual-accounts?_offset=30&_limit=10&_sort=-opening_date_time",
    "_last": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504/virtual-accounts?_offset=40&_limit=10&_sort=-opening_date_time"
  },
  "_count": "1"
}
VIRTUAL_ACCOUNTS_RESPONSE_WITH_EXPAND_BALANCES
{
  "accountsList": [
    {
      "accountDetails": {
        "displayNumber": "*0022",
        "nickName": "My eMoney Account",
        "baseCurrency": "GBP",
        "status": "Open",
        "accountIdentifiersList": [
          {
            "accountIdType": "uuid",
            "accountId": "0589bd6c-cca4-4b46-9c8a-b786171e66e1"
          },
          {
            "accountIdType": "iban",
            "accountId": "GB40PNXT09991100000022"
          },
          {
            "accountIdType": "bban",
            "accountId": "PNXT09991100000022",
            "country": "GB"
          }
        ],
        "customer": {
          "customerId": "PNXTGB2LXXXUS1234567890",
          "segmentCode": "sme",
          "customerName": "Customer Company Name"
        },
        "productId": "42dbdc87-a491-4566-bb97-eb2d9aea4707",
        "productName": "eMoney Account",
        "accounting": {
          "accountingId": "virtual_account",
          "accountingName": "Virtual Account"
        },
        "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": "74382f61-2410-4169-9ddc-ef8f892b3504"
          },
          {
            "realAccountIdType": "iban",
            "realAccountId": "GB20PAGO09197400000026"
          },
          {
            "realAccountIdType": "bban",
            "realAccountId": "9197400000026",
            "country": "GB"
          }
        ],
        "legalEntity": {
          "bic": "PNXTGB2LXXX",
          "legalEntityId": "pagonxt_uk",
          "legalEntityName": "PagoNxt OneTrade UK Ltd"
        },
        "openingDateTime": "2021-07-21T17:32:28.000Z",
        "lastUpdateDateTime": "2021-07-21T17:32:28.000Z",
        "closingDateTime": "2021-07-21T17:32:28.000Z",
        "additionalInfo": {}
      },
      "accountDetailsLink": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504?account_id_type=uuid",
      "transactionsListLink": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504/transactions?account_id_type=uuid"
    }
  ],
  "_links": {
    "_first": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504/virtual-accounts?_offset=0&_limit=10&_sort=-opening_date_time",
    "_prev": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504/virtual-accounts?_offset=10&_limit=10&_sort=-opening_date_time",
    "_next": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504/virtual-accounts?_offset=30&_limit=10&_sort=-opening_date_time",
    "_last": "/accounts/74382f61-2410-4169-9ddc-ef8f892b3504/virtual-accounts?_offset=40&_limit=10&_sort=-opening_date_time"
  },
  "_count": "1"
}
Expand All
object

Data structure showing all virtual account list.

accountsList
Array of object (VirtualAccountDetailsResponse)

Array of customer's accounts

Min items0
Max items200
object

Data structure showing all virtual account details.

accountDetails
object (Account)

Data structure containing account details.

displayNumber
string

Account number to be displayed. The entire account number is not displayed for privacy reasons.

Min length3
Max length255
Pattern^[a-zA-Z_0-9*-]*$
Example*0022
nickName
string | null

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.

Min length3
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleMy eMoney Account
baseCurrency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
status
string

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.
Valid values[ "Open", "Closed", "Blocked by customer", "Blocked", "Blocked-CR", "Blocked-DR" ]
ExampleOpen
accountIdentifiersList
Array of object (RealAccountId)

List of account Identifiers.

Min items0
Max items200
object

Identifier of an account. It is usually used to identify the real account related to a virtual account.

accountIdType
string

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)
Valid values[ "iban", "bban", "uuid" ]
Exampleiban
accountId
string

Identifier of an account.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleGB40PNXT09991100000022
country
string

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/).

Min length2
Max length2
Pattern^[A-Z]*$
ExampleGB
customer
object (CustomerAssociated)

Customer associated with an account.

customerId
string

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.

Min length8
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExamplePNXTGB2LXXXUS1234567890
segmentCode
string

Segment code (classification) in which the bank has categorized the customer. Possible values (sme, corp, mnc, bank, emi, api, regulated_corp, lc, fi, nbfi).

Valid values[ "sme", "corp", "mnc", "bank", "emi", "api", "regulated_corp", "lc", "fi", "nbfi" ]
Examplesme
customerName
string

Customer Name associated with the account

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleCustomer Company Name
productId
string

UUID identification type

Min length36
Max length36
Pattern^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
Example2507b89c-b680-46df-9505-e0b6f78cf295
virtualAccountStructureId
string

UUID identification type

Min length36
Max length36
Pattern^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
Example2507b89c-b680-46df-9505-e0b6f78cf295
productName
string

Name of the product associated with the account

Min length3
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleeMoney Account
accounting
object (Accounting)

Data structure that represent an account type.

accountingId
string

Accounting Identification of the customer account.

Min length0
Max length50
Pattern^[a-z_]*$
Exampleclient_account
accountingName
string

Accounting Name of the customer account.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleClient Account
legalEntity
object (LegalEntityDetails)

Legal Entity details object.

bic
string

Bic of the LegalEntity

Min length3
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExamplePNXTGB2LXXX
legalEntityId
string

Unique Identifier of the legal entity associated with the account

Min length3
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Examplepagonxt_uk
legalEntityName
string

Legal Name of the legal entity associated with the account

Min length3
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExamplePagoNxt OneTrade UK Ltd
balances
object

Data structure containing information related to different balances.

current
object (BaseBalance) | null

Base Balance and date of last change

amount
object (BalanceAmount)

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.

amount
number (double)

Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.

Separation is a point.

Minimum-2147483647
Maximum2147483647
Example99.99
currency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
lastChangeDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
consolidated
object (BaseBalance) | null

Base Balance and date of last change

amount
object (BalanceAmount)

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.

amount
number (double)

Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.

Separation is a point.

Minimum-2147483647
Maximum2147483647
Example99.99
currency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
lastChangeDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
pendingConsolidation
object (BaseBalance) | null

Base Balance and date of last change

amount
object (BalanceAmount)

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.

amount
number (double)

Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.

Separation is a point.

Minimum-2147483647
Maximum2147483647
Example99.99
currency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
lastChangeDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
withholding
object (BaseBalance) | null

Base Balance and date of last change

amount
object (BalanceAmount)

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.

amount
number (double)

Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.

Separation is a point.

Minimum-2147483647
Maximum2147483647
Example99.99
currency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
lastChangeDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
overdraft
object (BaseBalance) | null

Base Balance and date of last change

amount
object (BalanceAmount)

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.

amount
number (double)

Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.

Separation is a point.

Minimum-2147483647
Maximum2147483647
Example99.99
currency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
lastChangeDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
limit
object (BaseBalance) | null

Base Balance and date of last change

amount
object (BalanceAmount)

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.

amount
number (double)

Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.

Separation is a point.

Minimum-2147483647
Maximum2147483647
Example99.99
currency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
lastChangeDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
available
object (BaseBalance) | null

Base Balance and date of last change

amount
object (BalanceAmount)

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.

amount
number (double)

Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.

Separation is a point.

Minimum-2147483647
Maximum2147483647
Example99.99
currency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
lastChangeDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
realAccountAvailable
object (BaseBalance) | null

Base Balance and date of last change

amount
object (BalanceAmount)

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.

amount
number (double)

Data in ISO 20022 format containing up to 18 digits from which 5 may be decimals.

Separation is a point.

Minimum-2147483647
Maximum2147483647
Example99.99
currency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
lastChangeDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
realAccountIdentifiersList
Array of object (RealAccountIdentifier)

List of real account Identifiers.

Min items0
Max items200
object

Identifier of a real account. It is usually used to identify the real account related to a virtual account.

realAccountId
string

Account identifier

Min length3
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExamplerealAccountId1
realAccountIdType
string

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)
Valid values[ "iban", "bban", "uuid" ]
Exampleiban
country
string

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/).

Min length2
Max length2
Pattern^[A-Z]*$
ExampleGB
openingDateTime
string (date-time)

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'

Example2017-07-21T17:32:28Z
lastUpdateDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
closingDateTime
string (date-time) | null

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'

Example2017-07-21T17:32:28Z
additionalInfo
object (AdditionalInfo)

Free JSON object.

Example{}
limits
Array of object (LimitResponse)

Data structure that represents all limits that an account has.

Min items0
Max items200
object

Response that retrieves all the limits based on specific filters.

limitId
string

UUID identification type

Min length36
Max length36
Pattern^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$
Example2507b89c-b680-46df-9505-e0b6f78cf295
limitCurrency
string

Currency code. The value is the alpha-3 format defined in ISO 4217 (https://www.iso.org/iso-4217-currency-codes.html).

Min length3
Max length3
Pattern^[A-Z]*$
ExampleGBP
limitAmount
string

Limit amount.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Example100
limitType
string

Indicates the type of limit.

Valid values[ "overdraft", "intra_day_limit", "pencil_limit", "balance_limit" ]
Examplebalance_limit
transactionsListLink
string

Link to the account transactions list.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ ''""]*$
Example/accounts/e0c38c29-cdc1-4c61-9c14-a877b72cf549/transactions?account_id_type=uuid
accountDetailsLink
string

Link to the account details.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ ''""]*$
Example/accounts/e0c38c29-cdc1-4c61-9c14-a877b72cf549?account_id_type=uuid
_links
object (Links)

Pagination Links.

_first
string

Link to the first page of the account list. The exact value depends on the data to be accessed. The exact content of the page depends on the input parameters provided in the request, such as the offset.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Example/accounts?_offset=0&_limit=10
_last
string

Link to the previous page of the account list. The exact value depends on the data to be accessed. The exact content of the page depends on the input parameters provided in the request, such as the offset.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Example/accounts?_offset=10&_limit=10
_prev
string

Link to the previous page of the account list. The exact value depends on the data to be accessed. The exact content of the page depends on the input parameters provided in the request, such as the offset.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Example/accounts?_offset=30&_limit=10
_next
string

Link to the last page of the account list. The exact value depends on the data to be accessed. The exact content of the page depends on the input parameters provided in the request, such as the offset.

Min length0
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Example/accounts?_offset=40&_limit=10
_count
integer (int64)

Define the count pagination component

Minimum0
Maximum99999999
Example1
204

No content

400

Bad Request

INVALID_SCHEMA
{
  "errors": [
    {
      "code": "INVALID_SCHEMA",
      "message": "Invalid input.",
      "level": "ERROR",
      "description": "Error validating schema."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
401

Data structure showing an error 401 related to account types.

ACCOUNT_TYPE_ERROR
{
  "errors": [
    {
      "code": "ACCOUNT_TYPE_ERROR",
      "level": "ERROR",
      "message": "This account type has no access to get all virtual accounts",
      "description": "This account type \"virtual_account\" has no access to get all virtual accounts."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
403

Forbidden

OPERATION_NOT_ALLOWED
{
  "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."
    }
  ]
}
INVALID_AUTH_TOKEN
{
  "errors": [
    {
      "code": "INVALID_AUTH_TOKEN",
      "message": "The token provided is invalid.",
      "level": "ERROR",
      "description": "Invalid auth token."
    }
  ]
}
FORBIDDEN
{
  "errors": [
    {
      "code": "FORBIDDEN",
      "message": "A token must be provided.",
      "level": "ERROR",
      "description": "Operation not allowed due to lack of permissions."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
404

Data structure showing an account does not exist in the system.

NOT_FOUND
{
  "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."
    }
  ]
}
ACCOUNT_NOT_FOUND
{
  "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."
    }
  ]
}
REAL_ACCOUNT_VIRTUAL_STRUCTURE_NOT_EXIST
{
  "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."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
405

Method Not Allowed

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."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
406

Not Acceptable

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."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
409

Conflict

CONFLICT
{
  "errors": [
    {
      "code": "CONFLICT",
      "level": "ERROR",
      "message": "Conflict",
      "description": "This response is sent when a request conflicts with the current state of the server."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
413

Payload too large

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."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
414

Request URI Too Long

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."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
415

Unsupported Media Type

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."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
422

Unprocessable Entity

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."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
429

Too Many Requests

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"
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
500

Internal Server Error

INTERNAL_SERVER_ERROR
{
  "errors": [
    {
      "code": "INTERNAL_SERVER_ERROR",
      "message": "Internal Server Error.",
      "level": "ERROR",
      "description": "INTERNAL_SERVER_ERROR"
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
503

Service Down Error

SERVICE_ERROR
{
  "errors": [
    {
      "code": "SERVICE_DOWN_ERROR",
      "message": "Service down error.",
      "level": "ERROR",
      "description": "Service down error."
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
504

Gateway Timeout Error

GATEWAY_TIMEOUT
{
  "errors": [
    {
      "code": "GATEWAY_TIMEOUT_ERROR",
      "message": "Gateway timeout error.",
      "level": "ERROR",
      "description": "Gateway timeout error"
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema
default

Internal Server Error

INTERNAL_SERVER_ERROR
{
  "errors": [
    {
      "code": "INTERNAL_SERVER_ERROR",
      "message": "Internal Server Error.",
      "level": "ERROR",
      "description": "INTERNAL_SERVER_ERROR"
    }
  ]
}
Expand All
object

Data structure containing the details for errors.

errors
Array of object (Error)

Array of errors.

Min items0
Max items50
object

Data structure containing error details.

code
string

Unique alphanumeric human readable error code.

Min length1
Max length255
Pattern^[a-zA-Z_0-9-]*$
ExampleINVALID_CODE
message
string

Brief summary of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
Exampleinvalid_message
level
string

Level of the reported issue. The possible values are:

  • ERROR
  • FATAL
  • INFO
  • WARNING
Valid values[ "ERROR", "FATAL", "INFO", "WARNING" ]
ExampleERROR
description
string

Detailed description of the reported issue.

Min length1
Max length255
Pattern^[a-zA-Z_0-9_@./#&+-_ '""]*$
ExampleError validating schema