GET /admin/billing/credit-notes
Paginate all credit notes (credit invoices), sorted by creation time in descending order.
Billing Service `bearerAuth` application/json
Request Parameters
| Name | In | Type | Required | Default | Example | Constraints | Description |
page |
query |
integer |
No |
1 |
|
|
Page number |
page_size |
query |
integer |
No |
20 |
|
|
Items per page |
Responses
| Status | Description | Schema |
| 200 | Credit note list query successful | dto.CreditNoteListResponse |
| 400 | Invalid request parameters | object |
| 401 | Unauthorized | object |
| 403 | No permission | object |
| 500 | Internal server error | object |
Referenced Schemas
dto.CreditNoteListResponse
| Field | Type | Required | Example | Constraints | Description |
code |
integer |
No |
|
|
|
items |
array of
See dto.CreditNoteResponse |
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) |
dto.CreditNoteResponse
| Field | Type | Required | Example | Constraints | Description |
amount |
number |
No |
99 |
|
|
applied_at |
string |
No |
2026-04-15T12:00:00Z |
|
|
credit_note_number |
string |
No |
CN-2026-001 |
|
|
invoice_number |
string |
No |
INV-2026-001 |
|
|
issued_at |
string |
No |
2026-04-15T10:00:00Z |
|
|
reason |
string |
No |
Service cancellation |
|
|
status |
string |
No |
issued |
|
|
tenant_id |
string |
No |
tnt_abc123 |
|
|
gitee_com_linmes_authms_base_dto.PageInfo
| Field | Type | Required | Example | Constraints | 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 |