GET `/billing/credit-balance/{tenant_id}`

Get the tenant's credit balance, sourced from refunds, prorated downgrades, promotional credits, etc. Credit balance can be used to offset future invoices.

Billing Service `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`tenant_id`	`path`	`string`	Yes				Tenant ID

Responses

Status	Description	Schema
200	Credit balance query successful	`dto.CreditBalanceDetailResponse`
400	Invalid request parameters	`object`
401	Unauthorized	`object`
500	Internal server error	`object`

Referenced Schemas

dto.CreditBalanceDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.CreditBalanceResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.CreditBalanceResponse

Field	Type	Required	Example
`balance`	`number`	No	`150`
`currency`	`string`	No	`CNY`
`tenant_id`	`string`	No	`tnt_xyz789`
`updated_at`	`string`	No	`2026-05-12T10:00:00Z`

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

GET /billing/credit-balance/{tenant_id}