Skip to main content
GET
https://api.novita.ai
/
openapi
/
v1
/
billing
/
bill
/
list
Query Usage-based Billing
curl --request GET \
  --url https://api.novita.ai/openapi/v1/billing/bill/list \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'
{
  "bills": [
    {
      "userId": "<string>",
      "startTime": "<string>",
      "endTime": "<string>",
      "billingMethod": "<string>",
      "productName": "<string>",
      "category": "<string>",
      "ownerID": "<string>",
      "billNum0": "<string>",
      "billNum1": "<string>",
      "basePrice0": "<string>",
      "basePrice1": "<string>",
      "discountPrice0": "<string>",
      "discountPrice1": "<string>",
      "amount": "<string>",
      "voucherAmount": "<string>",
      "payAmount": "<string>",
      "payAmountDisplay": "<string>",
      "pricePrecision": "<string>",
      "productId": "<string>"
    }
  ]
}

​
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. Options:
  • summary (Summary bill)
  • gpu (GPU instance)
  • llm (llm api)
  • serverless (Serverless Endpoint)
  • cloud_storage (Storage resources)
  • gen_api (Image/Video/Audio generation)
​
productName
string
Product name. Supports fuzzy matching.
​
startTime
string
Start time of the billing period to query, timestamp in seconds, default: 0.
​
endTime
string
End time of the billing period to query, timestamp in seconds, default: 0.
​
ownerId
string
Specify instance ID to query.

​
Response Parameters

​
bills
object[]
required
Pay-as-you-go instance billing information.