Last Updated: 27 July 2023 | Change Log
Account API
Request your account details for a single account or all accounts under an entity.
Make yourself familiar with our API Principles to ensure a resilient integration.
Get Started
Get started using our API Reference and set your headers.
Request
There are two ways you can retrieve the details of your account:
- by account number or
- by entity
Request by account number
GET https://try.access.worldpay.com/accounts/balance/
Query string parameters
/accounts/balance/{accountNumber}
Mandatory string parameter
| Field Name | Description | Data Type/Format | Length | Validation Criteria |
|---|---|---|---|---|
accountNumber | The account number. | String | 16 | Alphanumeric only. Special characters are restricted. |
Response
Schema
Your unique 6-digit ID given to you during the onboarding process.
Collection of account details.
Examples
{
"entity": "111155",
"accounts": [
{
"accountNumber": "1111550000000044",
"accountName": "PLN account",
"currency": "PLN",
"clearedBalance": 1418.64,
"unclearedBalance": 0,
"balance": 1418.64
}
]
}Errors
Check out our API reference for the error code schema.
Request by entity
GET https://try.access.worldpay.com/accounts/balance/
Query string parameters
/accounts/balance/?entity={entity}
Mandatory string parameter
| Field Name | Description | Data Type/Format | Min-Max Length | Validation Criteria |
|---|---|---|---|---|
entity | Unique ID given to you during the onboarding process. | String | 6 | Alphanumeric only. Special characters are restricted. |
Response
Response examples
{
"entity": "111155",
"accounts": [
{
"accountNumber": "1111550000000044",
"accountName": "PLN account",
"currency": "PLN",
"clearedBalance": 1418.64,
"unclearedBalance": 0,
"balance": 1418.64
},
{
"accountNumber": "1111550000000045",
"accountName": "EUR account",
"currency": "EUR",
"clearedBalance": 9997.01,
"unclearedBalance": 0,
"balance": 9997.01
},
{
"accountNumber": "1111550000000046",
"accountName": "USD account",
"currency": "USD",
"clearedBalance": 2235.11,
"unclearedBalance": 0,
"balance": 2235.11
}
]
}Response schema
Your unique 6-digit ID given to you during the onboarding process.
Collection of account details.
Errors
Check out our API reference for the full error code schema.