# Query Fixed-term 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-fixed-term-billing

# Query Fixed-term Billing

GET

/

openapi

/

v1

/

billing

/

bill

/

monthly

/

list

Try it

```
curl --request GET \
--url 'https://api.novita.ai/openapi/v1/billing/bill/monthly/list?category=gpu&startTime=1764547200&endTime=1767225599' \
--header 'Authorization: Bearer '
```

200

```
{
"bills": [
{
"userId": "",
"memberId": "",
"startTime": "1764547200",
"endTime": "1767225599",
"productName": "",
"productCategory": "gpu",
"ownerID": "",
"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": "",
"billingMethod": 2
}
]
}
```

##

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

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)

[​](#param-product-name)

productName

string

Product name. Supports fuzzy matching.

[​](#param-start-time)

startTime

integer

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

[​](#param-end-time)

endTime

integer

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

[​](#param-owner-id)

ownerId

string

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)

Response Parameters

[​](#param-bills)

bills

object[]

required

Subscription / fixed-term bill list.

Hide properties

[​](#param-user-id)

userId

string

required

User account ID.

[​](#param-member-id)

memberId

string

Member (sub-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-product-name-1)

productName

string

required

Product name.

[​](#param-product-category)

productCategory

string

required

Product type.

[​](#param-product-id)

productId

string

required

Product ID.

[​](#param-owner-id)

ownerID

string

required

Resource instance ID.

[​](#param-trade-mode)

tradeMode

string

required

Billing mode. `monthly` indicates subscription.

[​](#param-trade-type)

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)

[​](#param-billing-method)

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

[​](#param-base-price)

basePrice

string

required

Unit price.

[​](#param-bill-num)

billNum

string

required

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

[​](#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-create-time)

createTime

string

required

Bill creation time, Unix timestamp in seconds.

[​](#param-cycle)

cycle

string

required

Billing cycle, in `YYYY-MM` format.

[​](#param-storage-days)

storageDays

int32

Storage usage duration, in days.

```
curl --request GET \
--url 'https://api.novita.ai/openapi/v1/billing/bill/monthly/list?category=gpu&startTime=1764547200&endTime=1767225599' \
--header 'Authorization: Bearer '
```

200

```
{
"bills": [
{
"userId": "",
"memberId": "",
"startTime": "1764547200",
"endTime": "1767225599",
"productName": "",
"productCategory": "gpu",
"ownerID": "",
"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": "",
"billingMethod": 2
}
]
}
```

Last modified on June 2, 2026