Faster Payments

Retrieve account details

Changed on Nov 3, 2026

Retrieves the account details using the unique mid. This identifier can be found in the Hub in the Settings > Developers tab.

get/accounts/{mid}

Request

Base URL
https://test-api.acquired.com/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/acquired/apis/acquired-api/docs/accounts/:mid/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

midstring uuid required

Unique ID assigned by Acquired.com for the Mid.

Query parameters

filterstring

Filter the parameters that you want to return within the response.

Response

midstring uuid

The unique identifier assigned by Acquired.com for the Mid.

account_referencestring

A value to identify the account.

balancestring float

The current balance of the account.

available_balancestring float

The available balance of the current.

account_status'active'

Indicates whether the account is active or not.

createdstring date-time

The date and time the account record was created.

last_updatedstring date-time

The date and time the account record was last updated.

Example response

{
  "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"
  },
  "account_status": "active"
}

Changes

Nov 3, 20269c9e8ec96e98 Revision changes
- warning
  added the new AED enum value to the / response property for the response status
- warning
  added the new AUD enum value to the / response property for the response status
- warning
  added the new CAD enum value to the / response property for the response status
- warning
  added the new CHF enum value to the / response property for the response status
- warning
  added the new CNY enum value to the / response property for the response status
- warning
  added the new DKK enum value to the / response property for the response status
- warning
  added the new EUR enum value to the / response property for the response status
- warning
  added the new GBP enum value to the / response property for the response status
- warning
  added the new HKD enum value to the / response property for the response status
- warning
  added the new JPY enum value to the / response property for the response status
- warning
  added the new MXN enum value to the / response property for the response status
- warning
  added the new SEK enum value to the / response property for the response status
- warning
  added the new USD enum value to the / response property for the response status
- warning
  added the new ZAR enum value to the / response property for the response status
- info
  removed the aed enum value from the / response property for the response status
- info
  removed the aud enum value from the / response property for the response status
- info
  removed the cad enum value from the / response property for the response status
- info
  removed the chf enum value from the / response property for the response status
- info
  removed the cny enum value from the / response property for the response status
- info
  removed the dkk enum value from the / response property for the response status
- info
  removed the eur enum value from the / response property for the response status
- info
  removed the gbp enum value from the / response property for the response status
- info
  removed the hkd enum value from the / response property for the response status
- info
  removed the jpy enum value from the / response property for the response status
- info
  removed the mxn enum value from the / response property for the response status
- info
  removed the sek enum value from the / response property for the response status
- info
  removed the usd enum value from the / response property for the response status
- info
  removed the zar enum value from the / response property for the response status

Operation history