# Beneficiary accounts

Retrieves a list of all beneficiary accounts in the Fund including account balance, type, status, and associated beneficiary information.

Endpoint: GET /f/{businessCode}/{fundCode}/beneficiary-data/list-beneficiary-accounts
Version: 1.0
Security: Class_oAuth

## Path parameters:

  - `businessCode` (string, required)
    Class business code

  - `fundCode` (string, required)
    Class entity code

## Response 200 fields (application/json):

  - `Data` (object, required)
    Represents a beneficiary's account within an Fund including balance and status information

  - `Data.Id` (string, required)
    The unique identifier for the beneficiary account
    Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

  - `Data.Description` (string, required)
    A description of the beneficiary account
    Example: Accumulation Account - John Smith

  - `Data.Type` (string, required)
    The type of Fund member account
    Example: Accumulation

  - `Data.Balance` (number, required)
    The current balance of the beneficiary account in AUD
    Example: 485000.5

  - `Data.Status` (string, required)
    The status of a beneficiary or account within the Fund
    Enum: "Active", "Cancelled", "Pending", "Suspended"

  - `Data.BeneficiaryName` (string, required)
    The full name of the beneficiary
    Example: John William Smith

  - `Data.BeneficiaryId` (string, required)
    The unique identifier for the beneficiary
    Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7

  - `Errors` (array)

  - `Errors.code` (string)

  - `Errors.message` (string)

## Response 400 fields (application/json):

  - `Errors` (array)

  - `Errors.code` (string)

  - `Errors.message` (string)

## Response 401 fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_NOT_AUTHORISED

  - `Errors.Message` (string)
    Example: Not authorised

## Response 403 fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: FORBIDDEN

  - `Errors.Message` (string)
    Example: You do not have permission to access this resource.

## Response 404 fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_NOT_FOUND

  - `Errors.Message` (string)
    Example: Resource not available or user does not have access to the fund.

## Response 500 fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    Example: An unexpected error occurred on the server. Please try again later.

## Response default fields (application/json):

  - `Errors` (array)

  - `Errors.Code` (string)
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    Example: An unexpected error occurred on the server. Please try again later.