# List Allocation Configurations

List all allocation configurations for the authenticated merchant.

Allocation configurations define how charges are split between multiple accounts
(e.g., divorced parents, household + subsidy agency).

Endpoint: GET /allocationConfigurations
Version: 1.0.0
Security: OAuth2

## Query parameters:

  - `page` (integer)
    Page number (1-indexed)
    Example: 1

  - `page_size` (integer)
    Number of items per page
    Example: 50

## Response 200 fields (application/json):

  - `results` (array, required)

  - `results.id` (string, required)

  - `results.entityId` (string, required)

  - `results.name` (string, required)

  - `results.description` (string)

  - `results.version` (integer, required)
    Business version number for allocation configuration history

  - `results.effectiveFrom` (string)

  - `results.rules` (array, required)

  - `results.rules.priority` (integer, required)
    Processing order (1 = first)

  - `results.rules.ruleType` (string, required)
    Type of allocation rule
    Enum: "RESPONSIBLE_PARTY", "COVERAGE_TRANSFER", "BILLING_CAP"

  - `results.rules.accountId` (string, required)
    Reference to Account in Profile Service

  - `results.rules.percentage` (number)
    For RESPONSIBLE_PARTY rules

  - `results.rules.fixedAmount` (integer)
    For COVERAGE_TRANSFER rules (in cents)

  - `results.rules.capAmount` (integer)
    For BILLING_CAP rules (in cents)

  - `results.rules.capPeriod` (string)
    Period for billing cap calculation
    Enum: "DAILY", "WEEKLY", "MONTHLY"

  - `results.rules.remainderHandling` (string)
    How to handle remainder amounts after cap
    Enum: "DISTRIBUTE_PROPORTIONALLY", "ASSIGN_TO_PRIMARY", "LEAVE_UNALLOCATED"

  - `results.optimisticLockVersion` (integer)
    Optimistic locking version (managed by Hibernate @Version). Prevents concurrent update conflicts.

  - `results.createdAt` (string, required)

  - `results.updatedAt` (string)

  - `pagination` (object, required)

  - `pagination.totalRecords` (integer, required)
    Total number of records across all pages
    Example: 100

  - `pagination.currentPage` (integer, required)
    Current page number (1-indexed)
    Example: 1

  - `pagination.totalPages` (integer, required)
    Total number of pages
    Example: 10

  - `pagination.nextPage` (integer,null)
    Next page number, null if on last page
    Example: 2

  - `pagination.prevPage` (integer,null)
    Previous page number, null if on first page

## Response 401 fields (application/json):

  - `result` (object, required)

  - `result.status` (string, required)
    Response status (always ERROR for error responses)
    Enum: "ERROR"

  - `error` (object, required)

  - `error.responseCode` (string, required)
    Response code (numeric or contains numbers, e.g., "404", "409", "500", "ERR001")
    Example: "404"

  - `error.responseMessage` (array, required)
    Array of error message strings for multiple error details
    Example: ["Charge not found","The requested charge ID does not exist in the system"]