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
}
Basic
Query Transactions
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
string
required
Enum:
application/jsonstring
required
Bearer authentication format, for example: Bearer {{API Key}}.
Query Parameters
int32
required
Page number, starting from
1.int32
required
Number of items per page.
string
Transaction serial number.
integer
Transaction start time, Unix timestamp in seconds (int64).
integer
Transaction end time, Unix timestamp in seconds (int64).
string
Transaction type. Common values:
recharge, refund, consume.string
Transaction channel. Common values:
AliPay, WeixinPay, PublicRemittance.string
Transaction status:
pending, success, failed, expired.string
Transaction channel filter. Same as
transactionChannel. Prefer transactionChannel.string
Order type:
recharge, refund.Response Parameters
object[]
required
Transaction record list.
Hide properties
Hide properties
string
required
User account ID.
string
required
Transaction serial number.
string
required
Transaction time, Unix timestamp in seconds.
string
required
Transaction type.
string
required
Transaction channel.
string
required
Transaction amount, unit is 1/10000 USD.
string
required
Wallet balance after the transaction, unit is 1/10000 USD.
string
required
Transaction note.
string
required
Transaction status.
string
required
Transaction voucher or invoice URL.
string
required
Order type. Values:
recharge, refund.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 2, 2026