> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helloclever.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Allocation Recipient Accounts

> Lists the Payments Accounts that can receive a share of a split Payin. Call it with the `app-id` and `secret-key` of the **receiving account** (the account that takes the Payin). The receiving account is always left out, because it cannot be its own recipient.

Use the returned `account_uuid` values in `allocation_profile.recipients` when you create a Payin with [Create a Payin](/api/payin/create-a-payin) or a Payment Gateway 3 payin link.

No `currency` is needed: it is taken from the receiving account behind the `app-id`, so only accounts in the Payin currency are listed.

Available to Clever Connect accounts on Dedicated Balance, for currencies where fund splitting is enabled. See [Platform Fees](/platform-overview/clever-concepts/platform-fees).



## OpenAPI

````yaml /api/openapi/v2-reference.yaml get /v2/merchant_allocation_profiles/accounts
openapi: 3.0.2
info:
  title: Multi-currency Payment APIs
  description: >-
    ## Introduction

    The Multi-currency Payment API Solution provides developers with a unified
    API schema to support multiple currencies efficiently. These APIs enable
    seamless transactions for both payin and payout operations, ensuring a
    robust, reliable, and scalable payment infrastructure for businesses dealing
    with various currencies.

    ### Key Features

    - **Single API Schema**: A single schema supports all currencies in your
    account, simplifying integration and management.

    - **Payin and Payout Process**:
      - **Step 1**: Call the **Get payin method list** to retrieve the list of supported methods.
      - **Step 2**: Call the **Get payin required fields** to get specific required fields for each method.
      - **Step 3**: Create the payment using the method and required fields from the previous step.
      - **Step 4**: On the sandbox environment, you can call the **Simulate payin** to simulate the payment.

    <div class="gst-note-red">
      Please note: GST should only be set to <code>true</code> for AU Merchants for <b>AUD</b> currency only. For all other currencies, set GST to <code>false</code>.
    </div>

    This documentation provides detailed guidance for integrating these
    capabilities into your application.
  version: 2.0.0
  termsOfService: https://helloclever.co/terms
  contact:
    email: support@helloclever.co
servers:
  - url: https://api.cleverhub.co/api
    description: Sandbox Environment
  - url: https://api-merchant.helloclever.co/api
    description: Production Environment
security:
  - app-id: []
    secret-key: []
paths:
  /v2/merchant_allocation_profiles/accounts:
    get:
      tags:
        - Platform Fee
      summary: Get Allocation Recipient Accounts
      description: >-
        Lists the Payments Accounts that can receive a share of a split Payin.
        Call it with the `app-id` and `secret-key` of the **receiving account**
        (the account that takes the Payin). The receiving account is always left
        out, because it cannot be its own recipient.


        Use the returned `account_uuid` values in
        `allocation_profile.recipients` when you create a Payin with [Create a
        Payin](/api/payin/create-a-payin) or a Payment Gateway 3 payin link.


        No `currency` is needed: it is taken from the receiving account behind
        the `app-id`, so only accounts in the Payin currency are listed.


        Available to Clever Connect accounts on Dedicated Balance, for
        currencies where fund splitting is enabled. See [Platform
        Fees](/platform-overview/clever-concepts/platform-fees).
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  currency:
                    type: string
                    description: Currency of the listed accounts.
                  accounts:
                    type: array
                    description: >-
                      Payments Accounts in this currency that can be allocation
                      recipients.
                    items:
                      type: object
                      properties:
                        account_uuid:
                          type: string
                          description: >-
                            Account UUID. Use it in
                            `allocation_profile.recipients`.
                        account_name:
                          type: string
                          description: >-
                            Account nickname, or account name when no nickname
                            is set.
              examples:
                AUD:
                  summary: AUD
                  value:
                    currency: AUD
                    accounts:
                      - account_uuid: WJWAOSCM
                        account_name: Store North
                      - account_uuid: 4A0FWJPW
                        account_name: Store South
        '422':
          description: Fund splitting is not available for this merchant or currency.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: object
                    properties:
                      message:
                        type: string
              examples:
                Fund splitting disabled:
                  summary: Fund splitting disabled
                  value:
                    errors:
                      message: >-
                        Fund splitting is not enabled for this currency. Please
                        contact your administrator for assistance.
                Not dedicated balance:
                  summary: Not dedicated balance
                  value:
                    errors:
                      message: >-
                        This feature is only available for merchants with
                        dedicated balance mode enabled.
components:
  securitySchemes:
    app-id:
      type: apiKey
      in: header
      name: app-id
      description: |
        A unique identifier assigned to each application.
    secret-key:
      type: apiKey
      in: header
      name: secret-key
      description: |
        A secure token associated with the `app-id`.

````

## Related topics

- [Split Payins with Platform Fees](/developer-reference/api-use-cases/split-payins-with-platform-fees.md)
- [October 2026](/release-notes/2026-10.md)
- [Create a Payin](/api/payin/create-a-payin.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.