GET `/billing/alerts`

Paginate the list of configured usage alert rules, supports filtering by application ID, resource type, and status

Billing Service `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Description
`app_id`	`query`	`string`	No		Application ID (optional)
`resource_type`	`query`	`string`	No		Resource type (optional)
`status`	`query`	`string`	No		Alert status (active/silenced/triggered)
`page`	`query`	`integer`	No	`1`	Page number
`page_size`	`query`	`integer`	No	`20`	Items per page

Status	Description	Schema
200	Usage alert list query successful	`dto.UsageAlertListResponse`
400	Invalid request parameters	`object`
401	Unauthorized	`object`
500	Internal server error	`object`

Field	Type	Required	Description
`code`	`integer`	No
`items`	array of See `dto.UsageAlertResponse`	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)

Field	Type	Required	Example
`app_id`	`string`	No	`app_001`
`created_at`	`string`	No	`2026-05-01T00:00:00Z`
`id`	`string`	No	`ua_001`
`last_triggered_at`	`string`	No	`2026-05-10T08:00:00Z`
`name`	`string`	No	`API call volume alert`
`notification_channels`	`string`	No	`email,in_app`
`resource_type`	`string`	No	`api_calls`
`status`	`string`	No	`active`
`tenant_id`	`string`	No	`tnt_xyz789`
`threshold_percent`	`integer`	No	`80`
`updated_at`	`string`	No	`2026-05-05T10:00:00Z`

Field	Type	Required	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