Skip to content
APIs/Balances/
Get details for all your...

Balances (v1)

Request your account details for a single account or all accounts under an entity.

Authentication header

  Authorization: {your_credentials}

Replace {your_credentials} with your base64-encoded Basic Auth username and password given to you by your Implementation Manager.

You must use the Authorization header for any request you send to our Balances API.

Accept header

  Accept: application/vnd.worldpay.accounts.balance-v1+json

We use the Accept header to identify which version of our API you are using. You must use the Accept header for any request you send to our Balances API.

DNS whitelisting
Whitelist the following URLs:

  • https://try.access.worldpay.com/
  • https://access.worldpay.com/

Please ensure you use DNS whitelisting, not explicit IP whitelisting.

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Test (Try)
https://try.access.worldpay.com/
Live
https://access.worldpay.com/

Get account details

Request

Retrieve the details of one specific account.

Security
basicAuth
Path
accountNumberstringrequired

The account number

Headers
WP-CorrelationIdstring

Optional ID to trace requests, if not provided, it is generated.

Example: 15cd16b2-7b82-41cb-9b11-21be9dacad88
No request payload

Responses

OK response

Body
entitystring or null

Your unique 6-digit ID given to you during the onboarding process.

Example: "111155"
accountsArray of objects or null

Collection of account details.

accountNumberstring or null

The account number.

Example: "1111557890987654"
accountNamestring or null

The name of the account. (This is given to you during onboarding and typically consists of your merchant name followed by the currency code.)

Example: "Etsy GBP"
currencystring or null

The ISO 4217 currency codes of the account.

Example: "GBP"
clearedBalancenumber(double)

The cleared balance.

Example: 142.5
unclearedBalancenumber(double)

The uncleared balance.

Example: 100.8
balancenumber(double)

The total balance.

Example: 243.5
accountStatusstring or null

The status of the account.

Example: "ACTIVE"
Response
{
  "entity": "111155",
  "accounts": [
    {
      "accountNumber": "1111557890987654",
      "accountName": "Etsy GBP",
      "currency": "GBP",
      "clearedBalance": 142.5,
      "unclearedBalance": 100.8,
      "balance": 243.5,
      "accountStatus": "ACTIVE"
    }
  ]
}

Get details for all your accounts

Request

Retrieve account details for all your accounts.

Security
basicAuth
Query
entitystring

Your unique 6-digit ID given during the onboarding process.

Example: entity=11155
Headers
WP-CorrelationIdstring

Optional ID to trace requests, if not provided, it is generated.

Example: 15cd16b2-7b82-41cb-9b11-21be9dacad88
No request payload

Responses

OK response

Body
entitystring or null

Your unique 6-digit ID given to you during the onboarding process.

Example: "111155"
accountsArray of objects or null

Collection of account details.

accountNumberstring or null

The account number.

Example: "1111557890987654"
accountNamestring or null

The name of the account. (This is given to you during onboarding and typically consists of your merchant name followed by the currency code.)

Example: "Etsy GBP"
currencystring or null

The ISO 4217 currency codes of the account.

Example: "GBP"
clearedBalancenumber(double)

The cleared balance.

Example: 142.5
unclearedBalancenumber(double)

The uncleared balance.

Example: 100.8
balancenumber(double)

The total balance.

Example: 243.5
accountStatusstring or null

The status of the account.

Example: "ACTIVE"
Response
{
  "entity": "111155",
  "accounts": [
    {
      "accountNumber": "1111557890987654",
      "accountName": "Etsy GBP",
      "currency": "GBP",
      "clearedBalance": 142.5,
      "unclearedBalance": 100.8,
      "balance": 243.5,
      "accountStatus": "ACTIVE"
    }
  ]
}