Accounts

Create an account

Accounts can be created by Acquired admins in the Hub, merchants can then view these details. To locate your account_id values, navigate to Settings > Banking Services and locate the required account values.

Retrieve an account

You can retrieve all details relating to a specific account, including the sort_code and account_number that the banking provider has associated to the account. Simply submit a GET request to the /accounts endpoint, appending the required account_id to the URL. For more information on this process, please see our API reference guide.

GET /accounts/{account_id}:

{
  "mid": "4ebc5489-7b9f-4324-983e-07d4b2b00035",
  "account_reference": "Main Account",
  "account_detail": {
    "account_name": "Mr E Johnson",
    "sort_code": "123456",
    "account_number": "87654321",
    "iban": "GB29 NWBK 6016 1331 9268 19",
    "bic": "HBUKGB4B",
    "currency": "gbp"
  },
  "balance": 100.02,
  "available_balance": 90,
  "account_status": "active",
  "created": "2025-01-14T17:28:09.925Z",
  "last_updated": "2025-01-14T17:28:09.925Z"
}

📘

Note

Utilise our filter parameter to select what data is returned within the response. For further information, please refer to our pagination guide.

Retrieve all accounts

The GET /accounts endpoint provides an efficient way to retrieve a comprehensive list of accounts associated with your organisation. Designed as part of the Faster Payments service, this endpoint supports pagination and filtering, enabling users to manage accounts at scale and tailor responses to meet specific requirements. By leveraging this endpoint, developers can seamlessly integrate account management functionalities into their applications, ensuring streamlined access to critical account data.

This endpoint will retrieve the same parameters as in the /accounts/{mid} endpoint, but will show all associated accounts rather than a single account.

Internal transfer

Acquired allows merchants to transfer funds immediately between their accounts.

To process an internal transfer between your accounts, submit the transaction detail and the payment details to the /payments/internal-transfer endpoint.

Please refer to the API reference documentation for further information on this process.

Example request:

{
  "transaction": {
    "order_id": "1f1f2a61-5b68-4725-a0ce-9560514ec00b",
    "amount": 15.02,
    "currency": "gbp"
  },
  "payment": {
    "from_mid": "6cf0fed2-fa2c-4145-876f-38091fddcb1d",
    "to_mid": "a303519e-3b65-4a1e-b8b9-b480ade983f7",
    "reference": "InternalTransfer001"
  }
}

Example response:

In your response you will receive the status of the transaction and the created transaction_id. This transaction_id can then be used in a GET request to retrieve the transaction details.

{
  "status": "pending",
  "transaction_id": "8675253c-ac52-4871-8740-bf75dee1aba8"
}