# 查询欠费订单明细 - ListUnpaidOrders

## 简介

查询当前欠费（未支付）的订单明细列表





## 定义

### 公共参数

| 参数名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **Action**     | string  | 对应的 API 指令名称，当前 API 为 `ListUnpaidOrders`                        | **Yes** |
| **PublicKey**  | string  | 用户公钥，可从 [控制台](https://console.dezai.com/uaccount/api_manage) 获取                                             | **Yes** |
| **Signature**  | string  | 根据公钥及 API 指令生成的用户签名，参见 [签名算法](/docs/api/summary/signature.md)  | **Yes** |

### 请求参数

| 参数名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **EndTime** | int | 查询结束时间（Unix 时间戳，秒级）。需与 `StartTime` 同时提供 |**Yes**|
| **StartTime** | int | 查询开始时间（Unix 时间戳，秒级）。与 `EndTime` 同时提供时启用自定义周期查询；EndTime 必须大于 StartTime |**Yes**|
| **PageSize** | int | 每页数量（最小10，最大100） |**Yes**|
| **Page** | int | 页码,从1开始 |**Yes**|
| **ResourceIds.N** | string | key数组（多选，可选） |No|
| **ModelIds.N** | string | 模型ID数组（多选，可选） |No|
| **PricingUnits.N** | int | 计费单元数组（多选，可选） |No|
| **OrderTypes.N** | int | 订单类型数组（多选，可选） |No|
| **Regions.N** | string | 地域列表（多选，可选），参见 [地域和可用区列表](/docs/api/summary/regionlist) |No|
| **PricingSkus.N** | string | 计费 SKU 列表（可选） |No|
| **ProductCodes.N** | string | 产品类型列表（多选，可选），枚举值：`modelverse`、`sandbox` |No|

### 响应字段

| 字段名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **RetCode** | int | 返回状态码，为 0 则为成功返回，非 0 为失败 |**Yes**|
| **Action** | string | 操作指令名称 |**Yes**|
| **Message** | string | 返回错误消息，当 `RetCode` 非 0 时提供详细的描述信息 |No|
| **Orders** | array[[*UnpaidOrderItem*](#UnpaidOrderItem)] | 欠费订单明细列表 |**Yes**|

#### 数据模型


#### UnpaidOrderItem

| 字段名 | 类型 | 描述信息 | 必填 |
|:---|:---|:---|:---|
| **Region** | string | 地域代码 |No|
| **OrderNo** | string | 订单号 |No|
| **SourceOrderNo** | string | 来源订单号 |No|
| **CompanyID** | int | 公司id |No|
| **OrganizationID** | int | 组织ID |No|
| **OrganizationName** | string | 组织名称 |No|
| **UserEmail** | string | 用户邮箱 |No|
| **ChargeType** | int | 计费类型 |No|
| **ChargeTypeDisplay** | string | 计价方式显示名 |No|
| **Channel** | int | 渠道 |No|
| **Currency** | string | 币种（如：CNY、USD） |No|
| **CurrencyDisplay** | string | 币种显示名 |No|
| **ResourceID** | string | 模型key |No|
| **ResourceType** | int | 资源类型 |No|
| **ResourceTypeDisplay** | string | 资源类型显示名 |No|
| **ModelID** | string | 模型ID |No|
| **ModelName** | string | 模型名称 |No|
| **OrderType** | int | 订单类型 |No|
| **OrderTypeDisplay** | string | 订单类型显示名 |No|
| **PricingSKU** | string | 计费单元（SKU）名称 |No|
| **Quantity** | int | 用量 |No|
| **QuantityDisplay** | string | 用量显示（含单位） |No|
| **PricingUnit** | int | 计费单位（计量单元） |No|
| **PricingUnitDisplay** | string | 计费单位显示名（如：千Token、张、秒） |No|
| **ListPrice** | string | 列表价（原单价） |No|
| **DiscountPrice** | string | 折后价（折后单价） |No|
| **OrderTotalPrice** | string | 订单总额 |No|
| **OriginalPrice** | string | 原价 |No|
| **Status** | int | 订单状态 |No|
| **StatusDisplay** | string | 订单状态显示名 |No|
| **CreateTime** | string | 创建订单时间（Unix 时间戳，秒级） |No|
| **StartTime** | int | 开始计费时间（Unix 时间戳，秒级） |No|
| **EndTime** | int | 结束计费时间（Unix 时间戳，秒级） |No|
| **PaidTime** | int | 订单支付时间（Unix 时间戳，秒级） |No|
| **RevocationTime** | string | 撤销时间（Unix 时间戳，秒级） |No|
| **RegionDisplay** | string | 地域显示名 |No|
| **ProductCode** | string | 产品类型 |No|
| **ProductCodeDisplay** | string | 产品类型显示名 |No|

## 示例

### 请求示例
    
```
https://api.dezai.com/?Action=ListUnpaidOrders
&Region=cn-zj
&Zone=cn-zj-01
&ProjectId=zqPPMqBX
&Page=8
&PageSize=5
&ResourceIds.N=KrvxcKCz
&ModelIds.N=jYCYycUM
&PricingUnits.N=8
&OrderTypes.N=6
&StartTime=4
&EndTime=9
&Regions.N=hyVxsESW
&PricingSkus.N=smcMOmBi
&ProductCodes.N=zZgIeVcp
```

### 响应示例
    
```json
{
  "Action": "ListUnpaidOrdersResponse",
  "Data": {},
  "RetCode": 0
}
```