> ## 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 Fixed-term Billing

## Request Headers

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

Enum: `application/json`

**Authorization** `string` *required*

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

## Query Parameters

**category** `string`

Product type. Common values:

* `summary` (Summary bill)
* `gpu` (GPU instance)
* `serverless` (Serverless Endpoint)
* `cloud_storage` (Cloud storage)
* `local_storage` (Local storage)
* `image` (Image)
* `bare_metal` (Bare metal)

**productName** `string`

Product name. Supports fuzzy matching.

**startTime** `integer`

Start time of the billing period to query, Unix timestamp in seconds (int64).

**endTime** `integer`

End time of the billing period to query, Unix timestamp in seconds (int64).

**ownerId** `string`

Resource instance ID.

> [!NOTE]
>
> This endpoint does not support pagination. Keep each query range within 31 days. For longer ranges, split requests by calendar month or calendar week.

## Response Parameters

**bills** `object[]` *required*

Subscription / fixed-term bill list.

**properties**

**userId** `string` *required*

User account ID.

**memberId** `string`

Member (sub-user) account ID.

**startTime** `string` *required*

Bill start time, Unix timestamp in seconds.

**endTime** `string` *required*

Bill end time, Unix timestamp in seconds.

**productName** `string` *required*

Product name.

**productCategory** `string` *required*

Product type.

**productId** `string` *required*

Product ID.

**ownerID** `string` *required*

Resource instance ID.

**tradeMode** `string` *required*

Billing mode. `monthly` indicates subscription.

**tradeType** `string` *required*

Subscription transaction type. Common values:

* `monthly_new_buy` (new purchase)
* `monthly_re_buy` (renewal)
* `monthly_re_config` (configuration change or scale-up)

**billingMethod** `int32` *required*

Billing method:

* `1`: pay-as-you-go
* `2`: subscription
* `3`: refund
* `4`: Spot billing
* `5`: Batch API
* `6`: Saving Plan
* `7`: LLM multimodal billing
* `8`: bare metal test deduction

**basePrice** `string` *required*

Unit price.

**billNum** `string` *required*

Usage. For `gpu`, this usually means GPU card count × subscription duration. For storage products, this usually means storage capacity.

**amount** `string` *required*

Total amount, unit is 1/10000 USD.

**voucherAmount** `string` *required*

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

**payAmount** `string` *required*

Cash payment amount, unit is 1/10000 USD.

**payAmountDisplay** `float` *required*

Display value of cash payment amount, in USD.

**pricePrecision** `int32` *required*

Price precision. Unit price (USD) = unit price / 10000 / `pricePrecision`.

**createTime** `string` *required*

Bill creation time, Unix timestamp in seconds.

**cycle** `string` *required*

Billing cycle, in `YYYY-MM` format.

**storageDays** `int32`

Storage usage duration, in days.

```bash theme={"system"}
curl --request GET \
  --url 'https://api.novita.ai/openapi/v1/billing/bill/monthly/list?category=gpu&startTime=1764547200&endTime=1767225599' \
  --header 'Authorization: Bearer <API_KEY>'
```

```json 200 theme={"system"}
{
  "bills": [
    {
      "userId": "<string>",
      "memberId": "<string>",
      "startTime": "1764547200",
      "endTime": "1767225599",
      "productName": "<string>",
      "productCategory": "gpu",
      "ownerID": "<string>",
      "tradeMode": "monthly",
      "tradeType": "monthly_new_buy",
      "basePrice": "1000000",
      "billNum": "1",
      "amount": "1000000",
      "voucherAmount": "0",
      "payAmount": "1000000",
      "payAmountDisplay": 100,
      "pricePrecision": 1,
      "createTime": "1764547200",
      "cycle": "2025-12",
      "productId": "<string>",
      "billingMethod": 2
    }
  ]
}
```


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