Query Fixed-term Billing

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

{
  "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
    }
  ]
}

GET

openapi

billing

bill

monthly

list

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

{
  "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
    }
  ]
}

Request Headers

string

obrigatório

Enum: application/json

string

obrigatório

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

Query Parameters

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)

string

Product name. Supports fuzzy matching.

integer

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

integer

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

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

object[]

obrigatório

Subscription / fixed-term bill list.

Ocultar properties

string

obrigatório

User account ID.

string

Member (sub-user) account ID.

string

obrigatório

Bill start time, Unix timestamp in seconds.

string

obrigatório

Bill end time, Unix timestamp in seconds.

string

obrigatório

Product name.

string

obrigatório

Product type.

string

obrigatório

Product ID.

string

obrigatório

Resource instance ID.

string

obrigatório

Billing mode. monthly indicates subscription.

string

obrigatório

Subscription transaction type. Common values:

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

int32

obrigatório

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

string

obrigatório

Unit price.

string

obrigatório

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

string

obrigatório

Total amount, unit is 1/10000 USD.

string

obrigatório

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

string

obrigatório

Cash payment amount, unit is 1/10000 USD.

float

obrigatório

Display value of cash payment amount, in USD.

int32

obrigatório

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

string

obrigatório

Bill creation time, Unix timestamp in seconds.

string

obrigatório

Billing cycle, in YYYY-MM format.

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 <API_KEY>'

{
  "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
    }
  ]
}

Última modificação em 10 de agosto de 2026

⌘I

Overview

Basic

Quota

Team Budget

API Key Model Access

Model APIs

GPUs

Query Fixed-term Billing

Request Headers

Query Parameters

Response Parameters

​Request Headers

​Query Parameters

​Response Parameters

Request Headers

Query Parameters

Response Parameters