GET `/internal/billing/subscription/{tenant_id}`

Internal service call: retrieve subscription details for a tenant via X-Tenant-ID and InternalAPIKey, for other microservices to query plan and feature permissions.

Billing Service - Internal API None application/json

Request Parameters

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

Responses

Status	Description	Schema
200	Subscription information retrieved successfully	`dto.SubscriptionDetailResponse`
400	Invalid request parameters	`object`
401	Unauthorized	`object`
500	Internal server error	`object`

Referenced Schemas

dto.SubscriptionDetailResponse

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

dto.SubscriptionResponse

Field	Type	Required	Example
`admin_user_id`	`string`	No	`usr_abc123`
`amount`	`number`	No	`499`
`auto_renew`	`boolean`	No	`True`
`billing_cycle`	`string`	No	`monthly`
`cancel_at_period_end`	`boolean`	No	`False`
`currency`	`string`	No	`CNY`
`current_period_end`	`string`	No	`2026-02-01T00:00:00Z`
`current_period_start`	`string`	No	`2026-01-01T00:00:00Z`
`grace_period_days`	`integer`	No	`7`
`plan_id`	`string`	No	`pro`
`status`	`string`	No	`active`
`tenant_id`	`string`	No	`tnt_xyz789`
`trial_end_date`	`string`	No	`2026-01-15T00:00:00Z`

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

GET /internal/billing/subscription/{tenant_id}