# Query Monthly Bill - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/api-reference/basic-query-monthly-bill

# Query Monthly Bill

GET

/

openapi

/

v1

/

billing

/

monthly

/

bill

Try it

```
curl --request GET \
--url 'https://api.novita.ai/openapi/v1/billing/monthly/bill?startMonth=2025-10&page=1&pageSize=20' \
--header 'Authorization: Bearer '
```

200

```
{
"data": [
{
"billId": "",
"userId": "",
"billingMonth": "2025-12",
"totalAmount": "1000000",
"originTotalAmount": "1200000",
"voucherPayAmount": "200000",
"cashPayAmount": "800000",
"debtAmount": "0",
"status": "paid",
"invoiceUrl": "",
"startTime": "1764547200",
"endTime": "1767225599",
"repaidAmount": "0"
}
]
}
```

##

[​](#request-headers)

Request Headers

[​](#param-content-type)

Content-Type

string

required

Enum: `application/json`

[​](#param-authorization)

Authorization

string

required

Bearer authentication format, for example: Bearer {{API Key}}.

##

[​](#query-parameters)

Query Parameters

[​](#param-start-month)

startMonth

string

Start month, in `YYYY-MM` format, for example `2025-10`. Monthly bill data is available starting from `2025-10`.

[​](#param-page)

page

int32

Page number, starting from `1`.

[​](#param-page-size)

pageSize

int32

Number of items per page.

The current production environment fills months starting from `startMonth`, so the returned item count may not strictly equal `pageSize`.

##

[​](#response-parameters)

Response Parameters

[​](#param-data)

data

object[]

required

Monthly bill list.

Hide properties

[​](#param-bill-id)

billId

string

required

Monthly bill ID.

[​](#param-user-id)

userId

string

required

User account ID.

[​](#param-billing-month)

billingMonth

string

required

Billing month, in `YYYY-MM` format.

[​](#param-total-amount)

totalAmount

string

required

Total amount payable, unit is 1/10000 USD.

[​](#param-origin-total-amount)

originTotalAmount

string

required

Original total amount before discounts or deductions, unit is 1/10000 USD.

[​](#param-voucher-pay-amount)

voucherPayAmount

string

required

Amount paid by vouchers, unit is 1/10000 USD.

[​](#param-cash-pay-amount)

cashPayAmount

string

required

Amount paid in cash, unit is 1/10000 USD.

[​](#param-debt-amount)

debtAmount

string

required

Overdue amount, unit is 1/10000 USD.

[​](#param-repaid-amount)

repaidAmount

string

required

Repaid amount, unit is 1/10000 USD.

[​](#param-status)

status

string

required

Monthly bill status. Possible values:

- `pending`

- `outed`

- `paid`

- `overdue`

- `voided`

[​](#param-invoice-url)

invoiceUrl

string

required

Bill or invoice download URL. Empty string means no downloadable file is available.

[​](#param-start-time)

startTime

string

required

Billing period start time, Unix timestamp in seconds.

[​](#param-end-time)

endTime

string

required

Billing period end time, Unix timestamp in seconds.

```
curl --request GET \
--url 'https://api.novita.ai/openapi/v1/billing/monthly/bill?startMonth=2025-10&page=1&pageSize=20' \
--header 'Authorization: Bearer '
```

200

```
{
"data": [
{
"billId": "",
"userId": "",
"billingMonth": "2025-12",
"totalAmount": "1000000",
"originTotalAmount": "1200000",
"voucherPayAmount": "200000",
"cashPayAmount": "800000",
"debtAmount": "0",
"status": "paid",
"invoiceUrl": "",
"startTime": "1764547200",
"endTime": "1767225599",
"repaidAmount": "0"
}
]
}
```

Last modified on May 25, 2026