Skip to content
Statements

List annual statements

Returns the current account's annual statements with pagination. Each item includes the statement ID, year, and generation time text. Use it for the list on the Annual Statement page. The Broker App sets page_size to 50 to fetch all records at once and shows them in descending order of year.

An item whose statement_id is 0 has not been generated yet: show it, but disable download. When statement_id is greater than 0, call GET /v1/portfolio/annual_statement/url to get the download URL. When items is empty, show empty_hint. Whether annual statements are available depends on account eligibility, which the server checks per account.

GEThttps://api.lbkrs.com/v1/portfolio/annual_statement/list

Parameters

pageintegerqueryRequired

Page number, starting from 1

page_sizeintegerqueryRequired

Records per page. The Broker App passes 50

aaidstringqueryRequired

Current account aaid

Responses

HTTP 200The request succeeded. The response body contains the result of the “List annual statements” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
itemsarray<object>required

Annual statements. Empty when there are no records

Child attributes
statement_idinteger

Annual statement ID used by “Get annual statement download URL”. 0 means the statement for that year has not been generated yet and cannot be downloaded

yearstring

Statement year as a four-digit string, such as 2025

generated_atstring

Generation time text returned by the server in the request language. It may describe when the statement was generated or when it is expected to be generated. Display it as is; do not parse it

pageintegerrequired

Current page number

page_sizeintegerrequired

Records per page

totalintegerrequired

Total number of records

empty_hintstring

Hint text returned by the server when items is empty. Display it as is

Whale Docs