> ## 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 Usage-based Billing

## Request Headers

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

Enum: `application/json`

**Authorization** `string` *required*

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

## Query Parameters

**cycleType** `string` *required*

Billing cycle granularity. Options: `Hour`, `Day`, `Week`, `Month`.

**productCategory** `string` *required*

Product type. Common values:

* `summary` (Summary bill)
* `gpu` (GPU instance)
* `llm` (LLM API)
* `serverless` (Serverless Endpoint)
* `cloud_storage` (Storage resources)
* `gen_api` (Image/Video/Audio generation)
* `cloud_sandbox` (Agent Sandbox)
* `llm_dedicated_endpoint` (LLM Dedicated Endpoint)
* `web_search` (Web Search)
* `bare_metal` (Bare Metal)

**productName** `string`

Product name. Supports fuzzy matching.

**category** `string`

Product subcategory.

**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*

Pay-as-you-go bill list.

**properties**

**userId** `string` *required*

User account ID.

**startTime** `string` *required*

Bill start time, Unix timestamp in seconds.

**endTime** `string` *required*

Bill end time, Unix timestamp in seconds.

**billingMethod** `int32` *required*

Billing method: `1` (pay-as-you-go), `2` (subscription).

**productName** `string` *required*

Product name.

**category** `string` *required*

Product type or subcategory.

**ownerID** `string` *required*

Resource instance ID.

**productId** `string` *required*

Product ID.

**billNum0** `string` *required*

Usage field 0. Meaning varies by product type:

* `llm`: input tokens.
* `gpu`: number of cards × billing duration.
* `cloud_storage`: storage capacity × billing duration.
* `serverless`: sum of worker count × duration.

**billNum1** `string` *required*

Usage field 1. For `llm`, this usually means output tokens.

**billNum2** `string` *required*

Usage field 2. For `llm`, this usually means read cache tokens.

**billNum3** `string` *required*

Usage field 3. For `llm`, this usually means write 5-minute cache tokens.

**billNum4** `string` *required*

Usage field 4. For `llm`, this usually means output reasoning tokens. Currently not supported.

**billNum5** `string` *required*

Usage field 5. For `llm`, this usually means write 1-hour cache tokens.

**billNum6** `string`

Usage field 6.

**billNum7** `string`

Usage field 7.

**billNum8** `string`

Usage field 8.

**billNum9** `string`

Usage field 9.

**billNum10** `string`

Usage field 10.

**billNum11** `string`

Usage field 11.

**billNum12** `string`

Usage field 12.

**billNum13** `string`

Usage field 13.

**billNum14** `string`

Usage field 14.

**billNum15** `string`

Usage field 15.

**basePrice0** `string` *required*

Original price field 0.

* `llm`: input price per 1M tokens.
* `gpu`: price per card per hour.
* `cloud_storage`: price per GB per day.

**basePrice1** `string` *required*

Original price field 1. For `llm`, this usually means the output price per 1M tokens.

**basePrice2** `string` *required*

Original price field 2. For `llm`, this usually means the read cache price per 1M tokens.

**basePrice3** `string` *required*

Original price field 3. For `llm`, this usually means the write 5-minute cache price per 1M tokens.

**basePrice4** `string` *required*

Original price field 4. For `llm`, this usually means the reasoning token price per 1M tokens.

**basePrice5** `string` *required*

Original price field 5. For `llm`, this usually means the write 1-hour cache price per 1M tokens.

**discountPrice0** `string` *required*

Discounted price field 0.

* `llm`: discounted input price per 1M tokens.
* `gpu`: discounted price per card per hour.
* `cloud_storage`: discounted price per GB per day.

**discountPrice1** `string` *required*

Discounted price field 1. For `llm`, this usually means the discounted output price per 1M tokens.

**discountPrice2** `string` *required*

Discounted price field 2. For `llm`, this usually means the discounted read cache price per 1M tokens.

**discountPrice3** `string` *required*

Discounted price field 3. For `llm`, this usually means the discounted write 5-minute cache price per 1M tokens.

**discountPrice4** `string` *required*

Discounted price field 4. For `llm`, this usually means the discounted reasoning token price per 1M tokens.

**discountPrice5** `string` *required*

Discounted price field 5. For `llm`, this usually means the discounted write 1-hour cache price per 1M tokens.

**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`.

**llmSeries** `string`

LLM series.

**requestCount** `string`

Request count.

**multimodalPricing** `object`

Multimodal model billing details.

**tieredConfig** `object`

Tiered billing configuration.

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

```json 200 theme={"system"}
{
  "bills": [
    {
      "userId": "<string>",
      "startTime": "1764547200",
      "endTime": "1764633599",
      "billingMethod": 1,
      "productName": "<string>",
      "category": "llm",
      "ownerID": "<string>",
      "billNum0": "1000",
      "billNum1": "500",
      "basePrice0": "0",
      "basePrice1": "0",
      "discountPrice0": "0",
      "discountPrice1": "0",
      "amount": "10000",
      "voucherAmount": "0",
      "payAmount": "10000",
      "payAmountDisplay": 1,
      "pricePrecision": 1,
      "productId": "<string>"
    }
  ]
}
```


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