# Query Transactions - 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-transaction

# Query Transactions

GET

/

openapi

/

v1

/

bill

/

transaction

Try it

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

200

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

##

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

pageNo

int32

required

Page number, starting from `1`.

[​](#param-page-size)

pageSize

int32

required

Number of items per page.

[​](#param-serial-number)

serialNumber

string

Transaction serial number.

[​](#param-transaction-time-start)

transactionTimeStart

integer

Transaction start time, Unix timestamp in seconds (int64).

[​](#param-transaction-time-end)

transactionTimeEnd

integer

Transaction end time, Unix timestamp in seconds (int64).

[​](#param-transaction-type)

transactionType

string

Transaction type. Common values: `recharge`, `refund`, `consume`.

[​](#param-transaction-channel)

transactionChannel

string

Transaction channel. Common values: `AliPay`, `WeixinPay`, `PublicRemittance`.

[​](#param-status)

status

string

Transaction status: `pending`, `success`, `failed`, `expired`.

[​](#param-channel)

channel

string

Transaction channel filter. Same as `transactionChannel`. Prefer `transactionChannel`.

[​](#param-order-type)

orderType

string

Order type: `recharge`, `refund`.

##

[​](#response-parameters)

Response Parameters

[​](#param-data)

data

object[]

required

Transaction record list.

Hide properties

[​](#param-customer-id)

customerId

string

required

User account ID.

[​](#param-serial-number-1)

serialNumber

string

required

Transaction serial number.

[​](#param-transaction-time)

transactionTime

string

required

Transaction time, Unix timestamp in seconds.

[​](#param-transaction-type-1)

transactionType

string

required

Transaction type.

[​](#param-transaction-channel-1)

transactionChannel

string

required

Transaction channel.

[​](#param-transaction-amount)

transactionAmount

string

required

Transaction amount, unit is 1/10000 USD.

[​](#param-wallet-balance)

walletBalance

string

required

Wallet balance after the transaction, unit is 1/10000 USD.

[​](#param-note)

note

string

required

Transaction note.

[​](#param-state)

state

string

required

Transaction status.

[​](#param-invoice-url)

invoiceURL

string

required

Transaction voucher or invoice URL.

[​](#param-order-type-1)

orderType

string

required

Order type. Values: `recharge`, `refund`.

[​](#param-total)

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

200

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

Last modified on June 2, 2026