Skip to main content

Reseller balance movements (live WHMCS tblcredit)

GET 

/auth/balance/movements

Returns the authenticated reseller's balance movements chronologically (new → old). Source: live WHMCS tblcredit — exactly matching WHMCS Credit Management (all credit entries + used/invoice-applied credit included).

Important: Use GET /auth/balance for the current balance. Because this list is read directly from WHMCS there is no local sync lag; if the WHMCS replica is temporarily unreachable the list may come back empty.

reason values: manual_credit (admin credit load), refund (invoice-linked refund, related_invoice_id populated), apply_credit (payment made from credit, negative amount).

Isolation: A reseller sees only its own movements (client id filter).

amount sign: Positive = addition (credit loaded/refunded), Negative = outflow (payment from credit). new_balance is the cumulative balance including that movement. currency is the reseller's actual WHMCS currency (tblclients.currency).

NOTE: The local mod_reseller_credit_movements table is now fed only for the credit.added webhook; this list is NOT read from there.

Request

Responses

Movement list returned

Response Headers
    X-RateLimit-Limit

    The per-minute limit defined for this key

    X-RateLimit-Remaining

    Number of requests remaining in the current window

    X-RateLimit-Reset

    Unix epoch of the start of the next window (UTC seconds)