> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Query Usage-based Billing
## Request Headers
Enum: `application/json`
Bearer authentication format, for example: Bearer \{\{API Key}}.
## Query Parameters
Billing cycle granularity. Options: `Hour`, `Day`, `Week`, `Month`.
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)
Product name. Supports fuzzy matching.
Product subcategory.
Start time of the billing period to query, Unix timestamp in seconds (int64).
End time of the billing period to query, Unix timestamp in seconds (int64).
Resource instance ID.
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
Pay-as-you-go bill list.
User account ID.
Bill start time, Unix timestamp in seconds.
Bill end time, Unix timestamp in seconds.
Billing method: `1` (pay-as-you-go), `2` (subscription).
Product name.
Product type or subcategory.
Resource instance ID.
Product ID.
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.
Usage field 1. For `llm`, this usually means output tokens.
Usage field 2. For `llm`, this usually means read cache tokens.
Usage field 3. For `llm`, this usually means write 5-minute cache tokens.
Usage field 4. For `llm`, this usually means output reasoning tokens. Currently not supported.
Usage field 5. For `llm`, this usually means write 1-hour cache tokens.
Usage field 6.
Usage field 7.
Usage field 8.
Usage field 9.
Usage field 10.
Usage field 11.
Usage field 12.
Usage field 13.
Usage field 14.
Usage field 15.
Original price field 0.
* `llm`: input price per 1M tokens.
* `gpu`: price per card per hour.
* `cloud_storage`: price per GB per day.
Original price field 1. For `llm`, this usually means the output price per 1M tokens.
Original price field 2. For `llm`, this usually means the read cache price per 1M tokens.
Original price field 3. For `llm`, this usually means the write 5-minute cache price per 1M tokens.
Original price field 4. For `llm`, this usually means the reasoning token price per 1M tokens.
Original price field 5. For `llm`, this usually means the write 1-hour cache price per 1M tokens.
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.
Discounted price field 1. For `llm`, this usually means the discounted output price per 1M tokens.
Discounted price field 2. For `llm`, this usually means the discounted read cache price per 1M tokens.
Discounted price field 3. For `llm`, this usually means the discounted write 5-minute cache price per 1M tokens.
Discounted price field 4. For `llm`, this usually means the discounted reasoning token price per 1M tokens.
Discounted price field 5. For `llm`, this usually means the discounted write 1-hour cache price per 1M tokens.
Total amount, unit is 1/10000 USD.
Amount deducted by vouchers, unit is 1/10000 USD.
Cash payment amount, unit is 1/10000 USD.
Display value of cash payment amount, in USD.
Price precision. Unit price (USD) = unit price / 10000 / `pricePrecision`.
LLM series.
Request count.
Multimodal model billing details.
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 '
```
```json 200 theme={"system"}
{
"bills": [
{
"userId": "",
"startTime": "1764547200",
"endTime": "1764633599",
"billingMethod": 1,
"productName": "",
"category": "llm",
"ownerID": "",
"billNum0": "1000",
"billNum1": "500",
"basePrice0": "0",
"basePrice1": "0",
"discountPrice0": "0",
"discountPrice1": "0",
"amount": "10000",
"voucherAmount": "0",
"payAmount": "10000",
"payAmountDisplay": 1,
"pricePrecision": 1,
"productId": ""
}
]
}
```