Skip to content
Longport WhaleLongport Whale
Bank Account Management

Bank Card Management - Recycle Bin

Query deleted client withdrawal bank cards (the bank-card recycle bin), used to trace and verify payout bank cards a client once bound and later removed.

Request parameters

  • Combine business filters through filters (see the filter field descriptions below), and use page, page_size, and orderBy to control pagination and sorting.

Business notes

  • The data source is client withdrawal bank-card records flagged as deleted; only cards in the deleted state are included. Records can be searched by client, card ID, bank account number, bank code, bank name, currency, verification status, country/region, FPS ID, creation time, and more.
  • Each record carries the client and securities account, account-holder name, bank account number, bank name/code, Swift Code, account region and address, card currency, withdrawal verification status, deposit attestation status, matched risk-control/AML rules, client and back-office remarks, and creation/update times.
  • Typically used by compliance, risk-control, and customer-service teams to review a client's historical bank-card bindings and check verification and attestation status after a card is deleted.

Returns

On success, returns the list of matching records with pagination information. See the response definition for column meanings.

POSThttps://b-api.lbkrs.com/v1/datasets/atm_withdraw_cards_deleted

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_account_withdraw_card.list

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

Request body application/json

filtersobject

Filters

Child attributes
member_idstring

Client

member_id is the customer ID. It differs from the securities account number account_no and the internal securities account ID aaid; one customer can have multiple securities accounts.

raw_member_idstring

Client ID

member_id_liststring

Client List

idstring

Client Bank Card ID

account_typestring

Currency. Values are dynamically queried from lb_account_types_currency_name (not fixed); fetch them live via GET /v1/datasets/refs/company_account_types.

statusstring

Verification Status

Allowed values: 0 Without Authentication, 1 Authentication In Progress, 2 Authentication Succeeded

Values
0
1
2
accountstring

Account

countrystring

Country

fps_idstring

FPS ID

name_enstring

Bank Card Name

regionstring

Bank Region. Values are dynamically queried from atm_regions (not fixed); fetch them live via GET /v1/datasets/refs/regions.

bank_codestring

Bank Code. Values are dynamically queried from atm_region_banks_code (not fixed); fetch them live via GET /v1/datasets/refs/region_banks_code.

multi_namestring

Bank Name

created_atobject

Created At. Range filter; both bounds are optional (omit a bound to leave that side unbounded).

Child attributes
gtestring

Greater Than or Equal

ltestring

Less Than or Equal

pageinteger

Page

page_sizeinteger

Page Size

orderByarray<object>

Order By

Responses

HTTP 200Paginated list result.
Standard response envelopecodemessagedata
dataobjectdata structure
listarray<object>required

List

Child attributes
idstring

Client Bank Card ID

id_valstring

Client Bank Card ID (raw value). Raw value behind field id: id returns the human-readable display value resolved via a dictionary/join mapping, while this field returns the underlying code/ID before that mapping.

member_idstring

Client ID

member_id_valstring

Client ID (raw value). Raw value behind field member_id: member_id returns the human-readable display value resolved via a dictionary/join mapping, while this field returns the underlying code/ID before that mapping.

origin_idsstring

A/C No.

name_enstring

Bank Card Name

accountstring

Account

fps_idstring

FPS ID

bank_account_typestring

Bank Account Type

account_typestring

Currency

account_type_valstring

Currency (raw value). Raw value behind field account_type: account_type returns the human-readable display value resolved via a dictionary/join mapping, while this field returns the underlying code/ID before that mapping.

bank_multi_namestring

Bank Name

nicknamestring

Nickname

bank_codestring

Bank Code

regionstring

Bank Region

region_valstring

Bank Region (raw value). Raw value behind field region: region returns the human-readable display value resolved via a dictionary/join mapping, while this field returns the underlying code/ID before that mapping.

countrystring

Country

provincestring

Province

citystring

City

postal_codestring

Postal Code

swift_codestring

Swift Code

addressstring

Address

custom_material_urlsstring

Supporting Materials

statusstring

Withdrawal Verification Status

status_valstring

Withdrawal Verification Status (raw value). Raw value behind field status: status returns the human-readable display value resolved via a dictionary/join mapping, while this field returns the underlying code/ID before that mapping.

custom_showstring

Deposit Attestation Status

created_atstring

Created At

updated_atstring

Update Time

remarkstring

Client's Remarks

admin_commentstring

Remarks

totalintegerrequired

Total

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