GET /billing/invoice/{invoice_number}

Query invoice details by invoice number, including amount, currency, line items, tax, payment status, etc.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
invoice_number	path	string	Yes				Invoice number

Responses

Status	Description	Schema
200	Invoice details query successful	dto.InvoiceDetailResponse
400	Invalid request parameters	object
401	Unauthorized	object
404	Invoice not found	object
500	Internal server error	object

Referenced Schemas

dto.InvoiceDetailResponse

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

dto.InvoiceLineItemResponse

Field	Type	Required	Example	Constraints	Description
amount	number	No	99
description	string	No	Professional Monthly Subscription
quantity	integer	No	1
resource_type	string	No	subscription
tax_amount	number	No	5.94
tax_rate	number	No	0.06
unit_price	number	No	99

dto.InvoiceResponse

Field	Type	Required	Example	Constraints	Description
amount	number	No	104.94
app_id	string	No	app_001
currency	string	No	CNY
due_date	string	No	2026-04-15T00:00:00Z
invoice_number	string	No	INV-2026-001
issued_at	string	No	2026-04-01T00:00:00Z
line_items	array of See dto.InvoiceLineItemResponse	No
paid_at	string	No	2026-04-10T15:00:00Z
status	string	No	issued
tenant_id	string	No	tnt_xyz789