> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novita.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Transactions

## 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.

**properties**

**customerId** `string` *required*

User account ID.

**serialNumber** `string` *required*

Transaction serial number.

**transactionTime** `string` *required*

Transaction time, Unix timestamp in seconds.

**transactionType** `string` *required*

Transaction type.

**transactionChannel** `string` *required*

Transaction channel.

**transactionAmount** `string` *required*

Transaction amount, unit is 1/10000 USD.

**walletBalance** `string` *required*

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

**note** `string` *required*

Transaction note.

**state** `string` *required*

Transaction status.

**invoiceURL** `string` *required*

Transaction voucher or invoice URL.

**orderType** `string` *required*

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

**total** `int32` *required*

Total number of transaction records matching the query.

```bash theme={"system"}
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>'
```

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.