# Query API Key Billing - 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-apikey-bill

# Query API Key Billing

GET

/

openapi

/

v1

/

billing

/

apikey

/

bill

/

list

Try it

```
curl --request GET \
--url 'https://api.novita.ai/openapi/v1/billing/apikey/bill/list?cycleType=Day&category=llm&startTime=1767225600&endTime=1769817599' \
--header 'Authorization: Bearer '
```

200

```
{
"bills": [
{
"userId": "",
"startTime": "1767225600",
"endTime": "1767311999",
"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": "",
"apikeyName": "",
"apikeyMask": "sk-****"
}
]
}
```

##

[​](#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-cycle-type)

cycleType

string

required

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

[​](#param-category)

category

string

Product type or business category. Common values: `llm`, `gen_api`, `web_search`.

[​](#param-product-name)

productName

string

Product name. Supports fuzzy matching.

[​](#param-start-time)

startTime

integer

required

Query start time, Unix timestamp in seconds (int64). Must be greater than or equal to `2026-01-01 00:00:00`.

[​](#param-end-time)

endTime

integer

required

Query end time, Unix timestamp in seconds (int64). Must be greater than `startTime`.

This endpoint only supports data after `2026-01-01 00:00:00`. It does not support pagination. Keep each query range within 31 days. For longer ranges, split requests by calendar month or calendar week.

##

[​](#response-parameters)

Response Parameters

[​](#param-bills)

bills

object[]

required

API Key bill list.

Hide properties

[​](#param-user-id)

userId

string

required

User account ID.

[​](#param-start-time-1)

startTime

string

required

Bill start time, Unix timestamp in seconds.

[​](#param-end-time-1)

endTime

string

required

Bill end time, Unix timestamp in seconds.

[​](#param-billing-method)

billingMethod

int32

required

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

[​](#param-product-name-1)

productName

string

required

Product name.

[​](#param-category-1)

category

string

required

Product type or subcategory.

[​](#param-owner-id)

ownerID

string

required

API Key ID.

[​](#param-apikey-name)

apikeyName

string

required

API Key name.

[​](#param-apikey-mask)

apikeyMask

string

required

Masked API Key.

[​](#param-product-id)

productId

string

required

Product ID.

[​](#param-bill-num0)

billNum0

string

required

Usage field 0. For `llm`, this usually means input price per 1M tokens; GPU: price per card per hour; storage: price per GB per day.

[​](#param-bill-num1)

billNum1

string

required

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

[​](#param-bill-num2)

billNum2

string

required

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

[​](#param-bill-num3)

billNum3

string

required

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

[​](#param-bill-num4)

billNum4

string

required

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

[​](#param-bill-num5)

billNum5

string

required

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

[​](#param-bill-num6)

billNum6

string

Usage field 6.

[​](#param-bill-num7)

billNum7

string

Usage field 7.

[​](#param-bill-num8)

billNum8

string

Usage field 8.

[​](#param-bill-num9)

billNum9

string

Usage field 9.

[​](#param-bill-num10)

billNum10

string

Usage field 10.

[​](#param-bill-num11)

billNum11

string

Usage field 11.

[​](#param-bill-num12)

billNum12

string

Usage field 12.

[​](#param-bill-num13)

billNum13

string

Usage field 13.

[​](#param-bill-num14)

billNum14

string

Usage field 14.

[​](#param-bill-num15)

billNum15

string

Usage field 15.

[​](#param-base-price0)

basePrice0

string

required

Original price field 0. For `llm`: input price per 1M tokens; GPU: price per card per hour; storage: price per GB per day.

[​](#param-base-price1)

basePrice1

string

required

Original price field 1. For `llm`, output price per 1M tokens.

[​](#param-base-price2)

basePrice2

string

required

Original price field 2. For `llm`, read cache price per 1M tokens.

[​](#param-base-price3)

basePrice3

string

required

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

[​](#param-base-price4)

basePrice4

string

required

Original price field 4. For `llm`, reasoning token price per 1M tokens.

[​](#param-base-price5)

basePrice5

string

required

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

[​](#param-discount-price0)

discountPrice0

string

required

Discounted price field 0. For `llm`, discounted input token price.

[​](#param-discount-price1)

discountPrice1

string

required

Discounted price field 1. For `llm`, discounted output token price.

[​](#param-discount-price2)

discountPrice2

string

required

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

[​](#param-discount-price3)

discountPrice3

string

required

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

[​](#param-discount-price4)

discountPrice4

string

required

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

[​](#param-discount-price5)

discountPrice5

string

required

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

[​](#param-amount)

amount

string

required

Total amount, unit is 1/10000 USD.

[​](#param-voucher-amount)

voucherAmount

string

required

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

[​](#param-pay-amount)

payAmount

string

required

Cash payment amount, unit is 1/10000 USD.

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

payAmountDisplay

float

required

Display value of cash payment amount, in USD.

[​](#param-price-precision)

pricePrecision

int32

required

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

[​](#param-llm-series)

llmSeries

string

LLM series.

[​](#param-request-count)

requestCount

string

Request count.

[​](#param-multimodal-pricing)

multimodalPricing

object

Multimodal model billing details.

[​](#param-tiered-config)

tieredConfig

object

Tiered billing configuration.

```
curl --request GET \
--url 'https://api.novita.ai/openapi/v1/billing/apikey/bill/list?cycleType=Day&category=llm&startTime=1767225600&endTime=1769817599' \
--header 'Authorization: Bearer '
```

200

```
{
"bills": [
{
"userId": "",
"startTime": "1767225600",
"endTime": "1767311999",
"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": "",
"apikeyName": "",
"apikeyMask": "sk-****"
}
]
}
```

Last modified on June 2, 2026