Skip to content
Longport WhaleLongport Whale
Agent Billing

Personal Fee Detail

Retrieve the fee configuration of a single personal fee record by id.

A personal fee configures a customer-specific rate that overrides the institution's default charging.

Request parameters

  • Required: id (personal fee record id), supplied in the path.
  • See the field descriptions for each field's format, value range, and business meaning.

Returns

On success, returns the personal fee configuration in data.fee (same structure as institution charging). See the 200 response field descriptions for field meanings.

GEThttps://b-api.lbkrs.com/billing/personal_fee/{id}

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_hk_charging.lb_hk_fee_level_query

The Broker ACCESS_TOKEN must be granted the permission above, or the call will be rejected.

Parameters

idstringRequired

Personal fee record id, supplied in the path.

Responses

HTTP 200The request was processed successfully. data.fee contains the fee configuration.
Standard response envelopecodemessagedata
dataobjectdata structure
feeobject

Fee configuration, same structure as "Company Fee Detail". Key sub-fields:

  • billing_item_id: id of the associated charging scene.
  • currency: currency.
  • min / max / threshold: billing range and starting threshold.
  • rates: tiered rate list; each tier has gt, lte, fee_rate, min.
  • fee_rate_type: fee rate type.
  • special_fees: special rate list (with conditions).
  • metric_type / granularity: metric type and billing granularity.
  • cutoff_method / cutoff_digits: rounding method and retained digits.
  • billing_item: embedded charging scene configuration; fields are the same as "Charging Scene Detail".
  • calculation_method: calculation method.
aaidstring

Internal securities account number aaid of the customer this personal rate belongs to; may be 0.

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