Skip to main content
GET
/
openapi
/
v1
/
bill
/
transaction
curl --request GET \
  --url 'https://api.novita.ai/openapi/v1/bill/transaction?pageNo=1&pageSize=20&transactionTimeStart=1764547200&transactionTimeEnd=1767225599' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "data": [
    {
      "customerId": "<string>",
      "serialNumber": "<string>",
      "transactionTime": "1764547200",
      "transactionType": "recharge",
      "transactionChannel": "AliPay",
      "transactionAmount": "1000000",
      "walletBalance": "1000000",
      "note": "",
      "state": "success",
      "invoiceURL": "",
      "orderType": "recharge"
    }
  ],
  "total": 1
}

ā€‹
Request Headers

ā€‹
Content-Type
string
required
Enum: application/json
ā€‹
Authorization
string
required
Bearer authentication format, for example: Bearer {{API Key}}.

ā€‹
Query Parameters

ā€‹
pageNo
int32
required
Page number, starting from 1.
ā€‹
pageSize
int32
required
Number of items per page.
ā€‹
serialNumber
string
Transaction serial number.
ā€‹
transactionTimeStart
integer
Transaction start time, Unix timestamp in seconds (int64).
ā€‹
transactionTimeEnd
integer
Transaction end time, Unix timestamp in seconds (int64).
ā€‹
transactionType
string
Transaction type. Common values: recharge, refund, consume.
ā€‹
transactionChannel
string
Transaction channel. Common values: AliPay, WeixinPay, PublicRemittance.
ā€‹
status
string
Transaction status: pending, success, failed, expired.
ā€‹
channel
string
Transaction channel filter. Same as transactionChannel. Prefer transactionChannel.
ā€‹
orderType
string
Order type: recharge, refund.

ā€‹
Response Parameters

ā€‹
data
object[]
required
Transaction record list.
ā€‹
total
int32
required
Total number of transaction records matching the query.
curl --request GET \
  --url 'https://api.novita.ai/openapi/v1/bill/transaction?pageNo=1&pageSize=20&transactionTimeStart=1764547200&transactionTimeEnd=1767225599' \
  --header 'Authorization: Bearer <API_KEY>'

{
  "data": [
    {
      "customerId": "<string>",
      "serialNumber": "<string>",
      "transactionTime": "1764547200",
      "transactionType": "recharge",
      "transactionChannel": "AliPay",
      "transactionAmount": "1000000",
      "walletBalance": "1000000",
      "note": "",
      "state": "success",
      "invoiceURL": "",
      "orderType": "recharge"
    }
  ],
  "total": 1
}
Last modified on June 12, 2026