GET /billing/usage/{tenant_id}/timeline

Query usage change time series data for a specified number of days, returning daily user count, API calls, storage, and bandwidth usage, for trend analysis charts

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)
days	query	integer	No	30			Number of days

Responses

Status	Description	Schema
200	Usage time series query successful	dto.UsageTimelineDetailResponse
400	Invalid request parameters	object
401	Unauthorized	object
500	Internal server error	object

Referenced Schemas

dto.UsageTimelineDetailResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.UsageTimelineResponse	No
message	string	No
timestamp	string	No

dto.UsageTimelinePoint

Field	Type	Required	Example	Constraints	Description
api_requests	integer	No	15000
bandwidth_gb	number	No	15
date	string	No	2026-05-01
storage_gb	number	No	2.5
users	integer	No	120

dto.UsageTimelineResponse

Field	Type	Required	Example	Constraints	Description
app_id	string	No	app_001
days	integer	No	30
tenant_id	string	No	tnt_xyz789
timeline	array of See dto.UsageTimelinePoint	No