GET /billing/usage/{tenant_id}

Query resource usage statistics for a specified tenant (user count, storage, API calls). Default queries last 30 days, can specify range via start_date/end_date.

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)
start_date	query	string	No	30 days ago			Start date (YYYY-MM-DD)
end_date	query	string	No	Today			End date (YYYY-MM-DD)

Responses

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

Referenced Schemas

dto.UsageStatItem

Field	Type	Required	Example	Constraints	Description
limit	integer	No	100
unit	string	No	units
used	integer	No	8

dto.UsageStatsDetailResponse

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

dto.UsageStatsResponse

Field	Type	Required	Example	Constraints	Description
api_calls	dto.UsageStatItem	No
app_id	string	No	app_001
period_end	string	No	2026-04-01
period_start	string	No	2026-03-01
storage	dto.UsageStatItem	No
tenant_id	string	No	tnt_xyz789
users	dto.UsageStatItem	No