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

# Query Transactions

## Request Headers

<ParamField header="Content-Type" type="string" required={true}>
  Enum: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format, for example: Bearer \{\{API Key}}.
</ParamField>

## Query Parameters

<ParamField query="pageNo" type="int32" required={true}>
  Page number, starting from `1`.
</ParamField>

<ParamField query="pageSize" type="int32" required={true}>
  Number of items per page.
</ParamField>

<ParamField query="serialNumber" type="string" required={false}>
  Transaction serial number.
</ParamField>

<ParamField query="transactionTimeStart" type="integer" required={false}>
  Transaction start time, Unix timestamp in seconds (int64).
</ParamField>

<ParamField query="transactionTimeEnd" type="integer" required={false}>
  Transaction end time, Unix timestamp in seconds (int64).
</ParamField>

<ParamField query="transactionType" type="string" required={false}>
  Transaction type. Common values: `recharge`, `refund`, `consume`.
</ParamField>

<ParamField query="transactionChannel" type="string" required={false}>
  Transaction channel. Common values: `AliPay`, `WeixinPay`, `PublicRemittance`.
</ParamField>

<ParamField query="status" type="string" required={false}>
  Transaction status: `pending`, `success`, `failed`, `expired`.
</ParamField>

<ParamField query="channel" type="string" required={false}>
  Transaction channel filter. Same as `transactionChannel`. Prefer `transactionChannel`.
</ParamField>

<ParamField query="orderType" type="string" required={false}>
  Order type: `recharge`, `refund`.
</ParamField>

## Response Parameters

<ResponseField name="data" type="object[]" required={true}>
  Transaction record list.

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="customerId" type="string" required={true}>
      User account ID.
    </ResponseField>

    <ResponseField name="serialNumber" type="string" required={true}>
      Transaction serial number.
    </ResponseField>

    <ResponseField name="transactionTime" type="string" required={true}>
      Transaction time, Unix timestamp in seconds.
    </ResponseField>

    <ResponseField name="transactionType" type="string" required={true}>
      Transaction type.
    </ResponseField>

    <ResponseField name="transactionChannel" type="string" required={true}>
      Transaction channel.
    </ResponseField>

    <ResponseField name="transactionAmount" type="string" required={true}>
      Transaction amount, unit is 1/10000 USD.
    </ResponseField>

    <ResponseField name="walletBalance" type="string" required={true}>
      Wallet balance after the transaction, unit is 1/10000 USD.
    </ResponseField>

    <ResponseField name="note" type="string" required={true}>
      Transaction note.
    </ResponseField>

    <ResponseField name="state" type="string" required={true}>
      Transaction status.
    </ResponseField>

    <ResponseField name="invoiceURL" type="string" required={true}>
      Transaction voucher or invoice URL.
    </ResponseField>

    <ResponseField name="orderType" type="string" required={true}>
      Order type. Values: `recharge`, `refund`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="int32" required={true}>
  Total number of transaction records matching the query.
</ResponseField>

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

<ResponseExample>
  ```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
  }
  ```
</ResponseExample>