Manage sterling accounts

A real account is a physical account held with ClearBank and can be used to send and/or receive payments.

Before creating an account, please check which account type you need. If you are unsure, please get in touch.

The balance of a real account is also held by ClearBank and can be viewed via the Institution portal and the ClearBank API. Real accounts are reconciled for you by ClearBank.

Get all accounts (real)

get/v3/Accounts

Gets all accounts associated with your institution.

All accounts are returned except those which have been disabled or where the account is a virtual account.

Parameters

pageNumber integer, query
The page number to control returned results into manageable sets. Default if not supplied: 1.
pageSize integer, query
The page size to control returned results into manageable sets. Default if not supplied: 50.
Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.

Response (application/json)

200 OK
400 Bad Request

OK

{
  "accounts": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "name": "Sample Account Type Name",
      "label": "John Smith",
      "type": "CACC",
      "currency": "GBP",
      "balances": [
        {
          "name": "Current Account",
          "amount": 0,
          "currency": "GBP",
          "status": "VALU"
        }
      ],
      "minimumBalance": {
        "name": "Current Account",
        "amount": 0,
        "currency": "GBP",
        "status": "VALU"
      },
      "status": "Enabled",
      "statusReason": "AccountHolderDeceased",
      "iban": "GB12CLBK01020312345678",
      "bban": "CLBK01020312345678",
      "upic": "string",
      "cuid": "string"
    }
  ],
  "halLinks": [
    {
      "name": "string",
      "href": "string",
      "templated": true
    }
  ]
}

Code copied

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Create an account (real)

post/v3/Accounts

Creates an account with the specified name.

Currently, this endpoint only supports the creation of current accounts.

AccountName must not be null, and must only contain whitespace, letters, numbers and the following special characters: - ,.
Account names are automatically prefixed with an abbreviated account-type label, depending on the account type.
For example, if an account were created with the following parameters:
AccountName: 'account one'
UsageType: 'Segregated Designated'
When inspected using the GET /v3/Accounts/{accountId} endpoint, the name would be returned as: `Des Seg Wsale account one`

UsageType specifies an account's type. The account type you choose should depend on your agreement with ClearBank, your FCA permissions, and the purpose of the account.
An account's usage type is immutable. Take care to set the correct usage type when making a new account.

This endpoint uses the X-Request-Id as a duplicate check and to ensure the request is idempotent.

Parameters

Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.
DigitalSignature string, header, Required
Signed hash of the body of the request. The hash is signed by your private key.
X-Request-Id string, header, Required
A unique identifier for the request; valid for 24 hours, max length 83.

Request Payload (application/json)

accountName string, Required
The friendly name that should be associated with the account.
Minimum length
1
Maximum length
70
Pattern
^[a-zA-Z0-9\- ,.&]*$
owner object, Required
Set of elements used to identify a person or an organisation.
sortCode string, Required
The sort code these accounts should be created under.
Pattern
^\d{6}$
usageType string
The type of funds the account will hold. Default if not supplied: YourFunds.
Enum array
YourFunds, SegregatedPooled, SegregatedDesignated, ClientMoneyPooled, ClientMoneyDesignated, SafeguardedPooled, SafeguardedDesignated, ClientSuspense

request

{
  "accountName": "Current Account",
  "owner": {
    "name": "John Smith"
  },
  "sortCode": "010203",
  "usageType": "YourFunds"
}

Code copied

Response (application/json)

201 Created
400 Bad Request
403 Forbidden
409 Conflict

Created

{
  "account": {
    "id": "01234567-89ab-cdef-0123-456789abcdef",
    "name": "Sample Account Type Name",
    "label": "John Smith",
    "type": "CACC",
    "currency": "GBP",
    "balances": [
      {
        "name": "Current Account",
        "amount": 0,
        "currency": "GBP",
        "status": "VALU"
      }
    ],
    "minimumBalance": {
      "name": "Current Account",
      "amount": 0,
      "currency": "GBP",
      "status": "VALU"
    },
    "status": "Enabled",
    "statusReason": "AccountHolderDeceased",
    "iban": "GB12CLBK01020312345678",
    "bban": "CLBK01020312345678",
    "upic": "string",
    "cuid": "string"
  },
  "halLinks": [
    {
      "name": "string",
      "href": "string",
      "templated": true
    }
  ]
}

Code copied

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Associated Webhooks

Account Created webhook

This webhook confirms the account has been created.

Request body

{
    "Type":"AccountCreated",
    "Version":1,
    "Payload": {...},
    "Nonce":
}

Payload

Element	Description
`AccountId`	Account identifier used to uniquely identify the account. Type: `string` Format: `GUID`
`AccountName`	Name of the account. Type: `string` Max. length: `128`
`AccountHolderLabel`	The account description. Type: `string` Max. length: `100`
`AccountIdentifiers`	Account identifier details. Type: `object` `IBAN`: International Bank Account Number associated with the account. Type: `string` Max. length: `34` `BBAN`: Basic Bank Account number associated with the account. Type: `string` Max. length: `30`
`TimestampCreated`	The date and time the account was created. Type: `string` Time Zone: `UTC` Format: `DateTime`
`AccountType`	Type of account. Type: `string` Examples: `CurrentAccount`, `DepositAccount`, `ControlAccount`, `SegregatedClientAccount`, `InstitutionAccount`
`Nonce`	Cryptographically secure number generated by ClearBank® for every single webhook. A nonce number is generated randomly and should not be used as a check for duplication.

Example account created webhook request body

{
    "Type":"AccountCreated",
    "Version":1,
    "Payload":{
        "AccountId":"56de3483-a569-42eb-90cc-acf59661356f",
        "AccountName":"JOHN DOE",
        "AccountHolderLabel":"JOHN DOE",
        "AccountIdentifiers":{
            "IBAN":"GB00CUBK11223312345678",
            "BBAN":"CUBK11223312345678"
        },
        "TimestampCreated":"2018-07-19T13:31:30.8789344Z",
        "AccountType":"CurrentAccount"
    },
    "Nonce":1082937278
}

Example webhook response

{
    "Nonce": 1082937278
}

Get information for an account (real)

get/v3/Accounts/{accountId}

Gets a detailed view of an account.

Parameters

accountId string, path, Required
The unique identifier for the account. This can be retrieved from GET /v3/Accounts.
Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.

Response (application/json)

200 OK
400 Bad Request
403 Forbidden
404 Not Found

OK

{
  "account": {
    "id": "01234567-89ab-cdef-0123-456789abcdef",
    "name": "Sample Account Type Name",
    "label": "John Smith",
    "type": "CACC",
    "currency": "GBP",
    "balances": [
      {
        "name": "Current Account",
        "amount": 0,
        "currency": "GBP",
        "status": "VALU"
      }
    ],
    "minimumBalance": {
      "name": "Current Account",
      "amount": 0,
      "currency": "GBP",
      "status": "VALU"
    },
    "status": "Enabled",
    "statusReason": "AccountHolderDeceased",
    "iban": "GB12CLBK01020312345678",
    "bban": "CLBK01020312345678",
    "upic": "string",
    "cuid": "string"
  },
  "halLinks": [
    {
      "name": "string",
      "href": "string",
      "templated": true
    }
  ]
}

Code copied

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Amend an account (real)

patch/v1/accounts/{accountId}

This endpoint is used to amend the properties of an existing real account.

Parameters

accountId string, path, Required
The unique identifier for the real account.
Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.
DigitalSignature string, header, Required
Signed hash of the body of the request. The hash is signed by your private key.
X-Request-Id string, header, Required
A unique identifier for the request; valid for 24 hours, max length 83.

Request Payload (application/json)

status string
Current status of the account. Valid options include Not Provided, Enabled, Closed, Suspended.
Enum array
NotProvided, Enabled, Closed, Suspended
statusReason string
Reason that the account is Closed or Suspended. Valid options include NotProvided, AccountHolderBankrupt, AccountHolderDeceased, AccountSwitched, CompanyNoLongerTrading, DissatisfiedCustomer, DuplicateSoleTraderAccount, FinancialCrime, FraudFirstParty, FraudThirdParty, FraudConfirmed, InternallyDormant, KYCRequired, LegallyDisputed, PotentialSanctionedIndividual, SanctionedIndividual, SuspectMoneyLaundering, TransactionDispute, Other.
Enum array
NotProvided, AccountHolderBankrupt, AccountHolderDeceased, AccountSwitched, CompanyNoLongerTrading, DissatisfiedCustomer, DuplicateSoleTraderAccount, FinancialCrime, FraudFirstParty, FraudThirdParty, Other, FraudConfirmed, InternallyDormant, KYCRequired, LegallyDisputed, PotentialSanctionedIndividual, SanctionedIndividual, SuspectMoneyLaundering, TransactionDispute
ownerName string
The name used to identify the legal owner of the account.
Minimum length
0
Maximum length
70
Pattern
^[^\|_\[\]<>^`~\\$]*$
legalOwnerType string
Nature of funds held in the account. Valid options include: Personal, Business.
Enum array
Personal, Business
relationshipType string
Operating nature of the account. Valid options include Single, Joint. If legalOwnerType is Business, then the relationshipType cannot be Joint.
Enum array
Single, Joint
minimumBalance number
The minimum allowable balance of the account (example: -£1000). Note that you must send a negative number to create an overdraft. This field can only be used if your organisation is an embedded banking client with an overdraft agreement in place; otherwise the request will be rejected.

request

{
  "status": "Enabled",
  "statusReason": "AccountHolderDeceased",
  "ownerName": "John Smith",
  "legalOwnerType": "Personal",
  "relationshipType": "Single",
  "minimumBalance": 0
}

Code copied

Response (application/json)

204 No content
400 Bad Request
403 Forbidden
409 Conflict

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Conflict

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Virtual accounts are held on your platform, but their funds are kept in a real account held with ClearBank.
To create a virtual account with ClearBank, you must create it under one of your real general (also known as pooled) accounts. You can then use this account's virtual IBAN (vIBAN) to send and receive payments using funds from the associated real account.
You can create virtual accounts using the POST /v2/Accounts/{accountId}/Virtual endpoint.

You are responsible for managing and reconciling your virtual accounts' balances.

Get accounts (virtual)

get/v1/accounts/virtual

Lists all of the virtual accounts belonging to an institution.

All virtual accounts are returned including those which have been disabled. A status field is available.

Parameters

pageNumber integer, query
The page number to control returned results into manageable sets. Default if not supplied: 1.
pageSize integer, query
The page size to control returned results into manageable sets. Default if not supplied: 50.
Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.

Response (application/json)

200 OK
400 Bad Request
403 Forbidden
404 Not Found

OK

{
  "accounts": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "name": "John Smith",
      "type": "CACC",
      "status": "Enabled",
      "currency": "GBP",
      "iban": "GB12CLBK01020312345678",
      "bban": "CLBK01020312345678",
      "upic": "string",
      "cuid": "string"
    }
  ],
  "halLinks": [
    {
      "name": "string",
      "href": "string",
      "templated": true
    }
  ]
}

Code copied

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Create accounts (virtual)

post/v2/Accounts/{accountId}/Virtual

Creates a series of virtual accounts.

This endpoint uses accountIdentifier as a duplicate check.

Parameters

accountId string, path, Required
The unique identifier for the real account. This can be retrieved from GET /v3/Accounts.
Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.
DigitalSignature string, header, Required
Signed hash of the body of the request. The hash is signed by your private key.
X-Request-Id string, header, Required
A unique identifier for the request; valid for 24 hours, max length 83.

Request Payload (application/json)

virtualAccounts array, Required
The virtual accounts that should be created.

request

{
  "virtualAccounts": [
    {
      "ownerName": "John Smith",
      "accountIdentifier": {
        "iban": "GB12CLBK01020312345678"
      }
    }
  ]
}

Code copied

Response (application/json)

202 Accepted
400 Bad Request
403 Forbidden
404 Not Found

Accepted

{
  "halLinks": [
    {
      "name": "string",
      "href": "string",
      "templated": true
    }
  ]
}

Code copied

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

This webhook confirms creation of a virtual account.

Version 3 has introduced the following new optional field:

ExternalIdentifier

The ExternalIdentifier field in both webhooks will show the externalId that you have specified instead of an account identifier (IBAN, BBAN or sort code and account number) at the time of creating a virtual account.

Request body

The request body consists of a DigitalSignature, Type,Version,Payload and Nonce. Payload parameters vary depending on the webhook. Webhook responses a 200 HTTP status code which includes a Nonce number in the body and your DigitalSignature.

{
    "Type":"VirtualAccountCreated",
    "Version":3,
    "Payload": {...},
    "OwnerName": ,
    "TimestampCreated": ,
    "Nonce":
}

Payload

Element	Description
`AccountId`	Required Unique identifier for the real account associated with the virtual account. Type: `string` Format:`GUID` Min. length: `1`
`VirtualAccountId`	Required Account identifier used to uniquely identify the virtual account. Type: `string` Format: `GUID` Min. length: `1`
`AccountIdentifier`	Required Virtual account identifier details. Type: `object` `IBAN`: International Bank Account Number associated with the virtual account. Type: `string` pattern: `^([A-Z]{2})([0-9]{2})([A-Za-z]{4})([0-9]{6})([0-9]{8})$` Min. length: `0` Max. length: `140` `BBAN`: Basic Bank Account number associated with the virtual account. Type: `string` Pattern: `^([A-Za-z]{4})([0-9]{6})([0-9]{8})$` Min. length: `0` Max. length: `140`
`ExternalIdentifier`	Optional Unique identifier specified at the time of creating a virtual account. Type: `string` Min. length: `0` Max. length: `50`
`OwnerName`	Optional Name for the owner of the virtual account. Type: `string` Min. length: `0` Max. length: `140`
`TimestampCreated`	Required The date and time the virtual account was created. Type: `string` Time Zone: `UTC` Format: `DateTime` Min. length: `1`
`Nonce`	Cryptographically secure number generated by ClearBank® for every single webhook. A nonce number is generated randomly and should not be used as a check for duplication.

Example virtual account created webhook request body

{
    "Type":"VirtualAccountCreated",
    "Version":3,
    "Payload":{
        "AccountId":"4fbe973b-2f30-45f0-b9e4-a488dd275861",
        "VirtualAccountId":"b3c93a68-5992-4f83-99d5-f13405fd2d90",
        "AccountIdentifier":{
            "Iban":"GB00CUBK22002243218765",
            "Bban":"CUBK22002243218765",
            "ExternalIdentifier":"98765432abcdefg"
        },
        "OwnerName":"Joe Brown",
        "TimestampCreated":"2018-07-19T13:44:56.7366698Z"
    },
    "Nonce":1623028327
}

Example webhook response

{
    "Nonce": 1623028327
}

This webhook confirms a virtual account creation failure.

Version 3 has introduced the following new optional field:

ExternalIdentifier

Request body

The request body consists of a DigitalSignature, Type,Version,Payload and Nonce. Payload parameters vary depending on the webhook. Webhook responses a 200 HTTP status code which includes a Nonce number in the body and your DigitalSignature.

{
    "Type":"VirtualAccountCreationFailed",
    "Version":3,
    "Payload": {...},
    "Errors":{...},
    "OwnerName": ,
    "Nonce":
}

Payload

Element	Description
`AccountId`	Required Unique identifier for the real account associated with the virtual account. Type: `string` Format:`GUID` Min. length: `1`
`VirtualAccountId`	Required Account identifier used to uniquely identify the virtual account. Type: `string` Format: `GUID` Min. length: `1`
`AccountIdentifiers`	Required Virtual account identifier details. Type: `object` `IBAN`: International Bank Account Number associated with the virtual account. Type: `string` pattern: `^([A-Z]{2})([0-9]{2})([A-Za-z]{4})([0-9]{6})([0-9]{8})$` Min. length: `0` Max. length: `140` `BBAN`: Basic Bank Account number associated with the virtual account. Type: `string` Pattern: `^([A-Za-z]{4})([0-9]{6})([0-9]{8})$` Min. length: `0` Max. length: `140`
`ExternalIdentifier`	Optional Unique identifier specified at the time of creating a virtual account. Type: `string` Min. length: `0` Max. length: `50`
`Errors`	Required Error(s) which caused the virtual account creation to fail. Type: `Object` One or more errors that occurred during the processing of the request: Additional Properties Type: `string` An error code and error explanation will be provided as a Key value pair These are some examples of error codes: `AccountIban`, `AccountIbanSortCode`, `AccountIbanAccountNumber`, `AccountBban`, `AccountBbanSortCode`, `AccountBbanAccountNumber`, `AccountIdentifiers`, `AccountName`, `AccountHolderLabel`, `AccountIbanBankCode`, `AccountBbanBankCode`, `ClientMoneyAccountIdMissing`, `ExternalVirtualAccountIdNotUnique`, `ExternalVirtualAccountId`, `VirtualAccountIdMissing`, `AccountModulusFailed`, `SortCodeDoesNotBelongToInstitution`, `SortCodeTypeIsIncorrect`
`OwnerName`	Optional Name for the owner of the virtual account. Type: `string` Min. length: `0` Max. length: `140`
`Timestamp`	Required The date and time the virtual account was created. Type: `string` Time Zone: `UTC` Format: `DateTime` Min. length: `1`
`Nonce`	Cryptographically secure number generated by ClearBank® for every single webhook. A nonce number is generated randomly and should not be used as a check for duplication.

Example virtual account creation failed webhook request body

{
    "Type":"VirtualAccountCreationFailed",
    "Version":3,
    "Payload":{
        "AccountId":"e2fb8de0-675d-479a-8b0f-596bc6f52a61",
        "VirtualAccountId":"ba393cc1-8f58-4542-b72f-db62910dce0e",
        "AccountIdentifier":{
            "Iban":"GB00CUBK22002243218765",
            "Bban":"CUBK22002243218765",
            "ExternalIdentifier":"98765432abcdefg"
        },
        "Errors":{
            "AccountIbanSortCode":"Invalid Sort Code"
        },
        "OwnerName":"Joe Brown",
        "Timestamp":"2018-07-19T13:44:56.7406379Z"
    },
    "Nonce":482504208
}

Example webhook response

{
    "Nonce": 482504208
}

Get all virtual accounts for a real account

get/v2/Accounts/{accountId}/Virtual

Lists all of the virtual accounts belonging to a given account.

All virtual accounts are returned including those which have been disabled. A Status field is available.

Parameters

accountId string, path, Required
The unique identifier for the real account. This can be retrieved from GET /v3/Accounts.
pageNumber integer, query
The page number to control returned results into manageable sets. Default if not supplied: 1.
pageSize integer, query
The page size to control returned results into manageable sets. Default if not supplied: 50.
Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.

Response (application/json)

200 OK
400 Bad Request
403 Forbidden
404 Not Found

OK

{
  "accounts": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "name": "John Smith",
      "label": "John Smith",
      "type": "CACC",
      "status": "Enabled",
      "currency": "GBP",
      "iban": "GB12CLBK01020312345678",
      "bban": "CLBK01020312345678",
      "upic": "string",
      "cuid": "string"
    }
  ],
  "halLinks": [
    {
      "name": "string",
      "href": "string",
      "templated": true
    }
  ]
}

Code copied

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Get information for an account (virtual)

get/v2/Accounts/{accountId}/Virtual/{virtualAccountId}

Gets a specific virtual account.

Parameters

accountId string, path, Required
The unique identifier for the real account. This can be retrieved from GET /v3/Accounts.
virtualAccountId string, path, Required
The unique identifier for the virtual account. This can be retrieved from GET /v2/Accounts/{accountId}/Virtual.
Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.

Response (application/json)

200 OK
400 Bad Request
403 Forbidden
404 Not Found

OK

{
  "account": {
    "id": "01234567-89ab-cdef-0123-456789abcdef",
    "name": "John Smith",
    "label": "John Smith",
    "type": "CACC",
    "status": "Enabled",
    "currency": "GBP",
    "iban": "GB12CLBK01020312345678",
    "bban": "CLBK01020312345678",
    "upic": "string",
    "cuid": "string"
  },
  "halLinks": [
    {
      "name": "string",
      "href": "string",
      "templated": true
    }
  ]
}

Code copied

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Not Found

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Amend an account (virtual)

patch/v1/accounts/{accountId}/virtual/{virtualAccountId}

This endpoint is used to amend the properties of an existing virtual account.

Parameters

accountId string, path, Required
The unique identifier for the real account. This can be retrieved from GET /v3/Accounts.
virtualAccountId string, path, Required
The unique identifier for the virtual account. This can be retrieved from GET /v2/Accounts/{accountId}/Virtual.
Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.
DigitalSignature string, header, Required
Signed hash of the body of the request. The hash is signed by your private key.
X-Request-Id string, header, Required
A unique identifier for the request; valid for 24 hours, max length 83.

Request Payload (application/json)

ownerName string
The name used to identify the legal owner of the virtual account.
Minimum length
1
Maximum length
140
Pattern
^[^\|_\[\]<>^`~\\$]*$
legalOwnerType string
Nature of funds held in the virtual account. Valid options include: Personal, Business.
Enum array
Personal, Business
relationshipType string
Operating nature of the virtual account. Valid options include Single, Joint. If legalOwnerType is Business, then the relationshipType cannot be Joint.
Enum array
Single, Joint

request

{
  "ownerName": "John Smith",
  "legalOwnerType": "Personal",
  "relationshipType": "Single"
}

Code copied

Response (application/json)

204 No content
400 Bad Request
403 Forbidden
404 Not Found
409 Conflict

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Disable an account (virtual)

delete/v1/accounts/{accountId}/virtual/{virtualAccountId}

Disables the virtual account that belongs to the given account.

Parameters

accountId string, path, Required
The unique identifier for the real account. This can be retrieved from GET /v3/Accounts.
virtualAccountId string, path, Required
The unique identifier for the virtual account. This can be retrieved from GET /v2/Accounts/{accountId}/Virtual.
Authorization string, header, Required
Your API Token, obtained from the ClearBank Portal.
X-Request-Id string, header, Required
A unique identifier for the request; valid for 24 hours, max length 83.

Response (application/json)

204 No content
400 Bad Request
403 Forbidden
404 Not Found

Bad Request

{
  "type": "../dictionary",
  "title": "string",
  "status": 100,
  "detail": "string",
  "instance": "../dictionary",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Code copied

Manage sterling accounts

Real GBP accounts

Get all accounts (real)

Parameters

Response (application/json)

Create an account (real)

Parameters

Request Payload (application/json)

Response (application/json)

Associated Webhooks

Get information for an account (real)

Parameters

Response (application/json)

Amend an account (real)

Parameters

Request Payload (application/json)

Response (application/json)

Virtual GBP accounts

Get accounts (virtual)

Parameters

Response (application/json)

Create accounts (virtual)

Parameters

Request Payload (application/json)

Response (application/json)

Associated Webhooks

Get all virtual accounts for a real account

Parameters

Response (application/json)

Get information for an account (virtual)

Parameters

Response (application/json)

Amend an account (virtual)

Parameters

Request Payload (application/json)

Response (application/json)

Disable an account (virtual)

Parameters

Response (application/json)