# List Unpaid Order Summary - ListUnpaidOrderSummary

## Overview

Query aggregated unpaid order statistics by specified dimensions






## Definition

### Public Parameters

| Parameter Name | Type | Description Information | Required |
|:---|:---|:---|:---|
| **Action**     | string  | Corresponding API command name, the current API is `ListUnpaidOrderSummary`.                      | **Yes** |
| **PublicKey**  | string  | The user's public key can be obtained from [Console](https://console.sigcalcloud.com/uaccount/api_manage)                                             | **Yes** |
| **Signature**  | string  | User signature generated based on public key and API command, see [Signature Algorithm](/docs/api/summary/signature.md)  | **Yes** |

### Request Parameters

| Parameter Name | Type | Description Information | Required |
|:---|:---|:---|:---|
| **StartTime** | int | Query start time (Unix timestamp, seconds), required |**Yes**|
| **EndTime** | int | Query end time (Unix timestamp, seconds), required; must be greater than StartTime |**Yes**|
| **ResourceIds.N** | string | API Key ID list (optional) |No|
| **OrderTypes** | int | Order type list (optional) |No|
| **ModelIds.N** | string | Model ID list (optional) |No|
| **PricingUnits.N** | int | Pricing unit list (optional) |No|
| **ChargeTypes.N** | int | Charge type list (optional) |No|
| **PricingSkus.N** | string | Billing unit SKU list (optional) |No|
| **Regions.N** | string | Region list (optional). See [Region and Zone List](/docs/api/summary/regionlist) |No|
| **OrganizationIds.N** | int | Organization ID list (optional) |No|

### Response Field

| Field Name | Type | Description Information | Required |
|:---|:---|:---|:---|
| **RetCode** | int | Return status code. If it is 0, it means successful return. If it is not 0, it means failure. |**Yes**|
| **Action** | string | Operation command name. |**Yes**|
| **Message** | string | Returns an error message, providing detailed description when `RetCode` is non-zero. |No|
| **Summaries** | array[[*OrderSummaryItem*](#ordersummaryitem)] | Unpaid order summary list |**Yes**|

#### Data Model


#### OrderSummaryItem

| Field Name | Type | Description Information | Required |
|:---|:---|:---|:---|
| **ResourceId** | string | Resource ID |No|
| **PricingSKU** | string | Billing unit SKU |No|
| **ModelID** | string | Model ID |No|
| **ModelName** | string | Model name |No|
| **PricingUnit** | int | Pricing unit (measurement unit) |No|
| **PricingUnitName** | string | Pricing unit name |No|
| **OrderType** | int | Order type  |No|
| **OrderTypeDisplay** | string | Order type display name |No|
| **ChargeType** | int | ChargeType |No|
| **Status** | int | Order status (2=Paid; 3=Cancelled) |No|
| **StatusDisplay** | string | Order status display name |No|
| **ListPrice** | string | <br />List price (original unit price) |No|
| **DiscountPrice** | string | Discounted unit price |No|
| **SumQuantity** | int | Total usage quantity (raw value) |No|
| **SumQuantityDisplay** | string | Total usage display (formatted, K tokens etc. are converted) |No|
| **SumOrderPrice** | string | Total order amount |No|
| **SumOriginalPrice** | string | Total original price |No|
| **SumCashAccount** | string | Total cash account deduction (only returned for paid orders) |No|
| **SumStarCardAccount** | string | Total Star Card deduction amount (only returned for paid orders) |No|
| **SumBonusAccount** | string | Total bonus account deduction (only returned for paid orders) |No|
| **SumCoupon** | string | Total coupon deduction (only returned for paid orders) |No|

## Example

### Request Example
    
```
https://api.sigcalcloud.com/?Action=ListUnpaidOrderSummary
&Region=cn-zj
&Zone=cn-zj-01
&ProjectId=cnSiQiol
&ResourceIds.N=AglVXrhh
&ModelIds.N=BQVSAjLU
&PricingUnits.N=3
&OrderTypes=1
&ChargeTypes.N=9
&StartTime=1
&EndTime=3
&PricingSkus.N=NFswTmQW
&Regions.N=uzZjhWLQ
&OrganizationIds.N=1
```

### Response Example
    
```json
{
  "Action": "ListUnpaidOrderSummaryResponse",
  "Data": {},
  "RetCode": 0
}
```