> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novita.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Monthly Bill

## Request Headers

**Content-Type** `string` *required*

Enum: `application/json`

**Authorization** `string` *required*

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

## Query Parameters

**startMonth** `string`

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

**page** `int32`

Page number, starting from `1`.

**pageSize** `int32`

Number of items per page.

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

## Response Parameters

**data** `object[]` *required*

Monthly bill list.

**properties**

**billId** `string` *required*

Monthly bill ID.

**userId** `string` *required*

User account ID.

**billingMonth** `string` *required*

Billing month, in `YYYY-MM` format.

**totalAmount** `string` *required*

Total amount payable, unit is 1/10000 USD.

**originTotalAmount** `string` *required*

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

**voucherPayAmount** `string` *required*

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

**cashPayAmount** `string` *required*

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

**debtAmount** `string` *required*

Overdue amount, unit is 1/10000 USD.

**repaidAmount** `string` *required*

Repaid amount, unit is 1/10000 USD.

**status** `string` *required*

Monthly bill status. Possible values:

* `pending`
* `outed`
* `paid`
* `overdue`
* `voided`

**invoiceUrl** `string` *required*

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

**startTime** `string` *required*

Billing period start time, Unix timestamp in seconds.

**endTime** `string` *required*

Billing period end time, Unix timestamp in seconds.

```bash theme={"system"}
curl --request GET \
  --url 'https://api.novita.ai/openapi/v1/billing/monthly/bill?startMonth=2025-10&page=1&pageSize=20' \
  --header 'Authorization: Bearer <API_KEY>'
```

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.