Skip to content
Fee Rate and Other Charges

Account Final Fees

Query a customer's final effective fee configuration by aaid (v4).

Request parameters

  • Required: aaid (customer account identifier).
  • Optional: policy_version (billing policy version; omit or 0 for the current effective version).

Result

On success, data.tabs returns the customer's final effective fee configuration grouped by market. See the 200 response fields for the meaning of each level.

GEThttps://b-api.longbridge.xyz/v4/billing/account_final_fees

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Parameters

aaidstringRequired

Customer account identifier (aaid).

policy_versionstring

Billing policy version. Omit or pass 0 for the current effective version.

Responses

HTTP 200The request was processed successfully. data.tabs contains the final fee configuration grouped by market.
Standard response envelopecodemessagedata
dataobjectdata structure
tabsarray<object>

List of fee tabs grouped by market.

Child attributes
namestring

Tab name, e.g. market-HK (by market).

cardsarray<object>

List of fee cards under this market.

Child attributes
biz_typeinteger

Business type.

affgsarray<object>

Fee aggregation list. Each item contains:

  • item: charging scene configuration; fields are the same as "Charging Scene Detail".
  • prm_fee: primary fee configuration (currency, min / max, rates tiered rates, package_id / package_name, level, etc.).
  • special_fees: special rate list; each item has conditions and its own rate parameters.
Child attributes
itemobject
prm_feeobject
special_feesarray<object>
HTTP 400Bad request. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

Whale Docs