GET /billing/records/{tenant_id}/search

Multi-condition combined search for billing records, filters include: status, date range, amount range, keyword search. Results returned with pagination.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
tenant_id	path	string	Yes				Tenant ID
app_id	query	string	No				Application ID (optional)
status	query	string	No				Billing status (paid/failed/refunded/pending)
date_from	query	string	No				Start date (YYYY-MM-DD)
date_to	query	string	No				End date (YYYY-MM-DD)
min_amount	query	number	No				Minimum amount
max_amount	query	number	No				Maximum amount
search	query	string	No				Keyword search
page	query	integer	No	1			Page number
page_size	query	integer	No	20			Items per page

Responses

Status	Description	Schema
200	Billing record search successful	dto.BillingRecordListResponse
400	Invalid request parameters	object
401	Unauthorized	object
500	Internal server error	object

Referenced Schemas

dto.BillingRecordListResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
items	array of See dto.BillingRecordResponse	No			Use items uniformly
message	string	No
pagination	object	No			Pagination information (nested object)
timestamp	string	No
total	integer	No			Total count (flattened for direct reading)

dto.BillingRecordResponse

Field	Type	Required	Example	Constraints	Description
amount	number	No	99
app_id	string	No	app_001
created_at	string	No	2026-04-01T00:00:00Z
currency	string	No	CNY
description	string	No	Professional Monthly Subscription
invoice_number	string	No	INV-2026-001
line_items	array of See dto.InvoiceLineItemResponse	No
record_id	string	No	rec_001
status	string	No	paid
tenant_id	string	No	tnt_xyz789
type	string	No	subscription

dto.InvoiceLineItemResponse

Field	Type	Required	Example	Constraints	Description
amount	number	No	99
description	string	No	Professional Monthly Subscription
quantity	integer	No	1
resource_type	string	No	subscription
tax_amount	number	No	5.94
tax_rate	number	No	0.06
unit_price	number	No	99

gitee_com_linmes_authms_base_dto.PageInfo

Field	Type	Required	Example	Constraints	Description
has_next	boolean	No			HasNext indicates whether there is a next page
has_prev	boolean	No			HasPrev indicates whether there is a previous page
page	integer	No			Page is the current page number (1-based)
page_size	integer	No			PageSize is the number of items per page
total	integer	No			Total is the total number of items across all pages
total_pages	integer	No			TotalPages is the total number of pages