---
title: "getContractUsageList"
slug: "platform-costandusage-getcontractusagelist"
tags: ["Cost And Usage"]
updated: 2026-09-17T09:57:14Z
published: 2026-09-17T09:57:14Z
canonical: "api.ncloud-docs.com/platform-costandusage-getcontractusagelist"
---

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

# getContractUsageList

Classic/VPC環境で利用できます。

契約使用量リストを照会します。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| GET | /cost/getContractUsageList |

### リクエストヘッダ

Cost and Usage APIで共通して使用されるヘッダの詳細は、[Cost and Usageの共通ヘッダ](/docs/ja/platform-costandusage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストクエリパラメータ

パラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `pageNo` | Integer | Optional | ページ番号 |
| `pageSize` | Integer | Optional | ページサイズ - 1,000以下(デフォルト: 1,000) |
| `isOrganization` | Boolean | Optional | Organizationサービスアカウントの統合照会かどうか - マスターのみ使用可能 - `isOrganization`、`isPartner`のいずれも``true`の場合、エラーを返す |
| `isPartner` | Boolean | Optional | パートナーアカウントの照会かどうか - パートナー代表のみ使用可能 - `isOrganization`、`isPartner`のいずれも``true`の場合、エラーを返す |
| `memberNoList` | List<String> | Optional | 会員番号リスト - マスターまたはパートナー代表のみ使用可能 |
| `contractNo` | String | Optional | 契約番号 |
| `startMonth` | String | Required | 照会開始月(yyyyMM) - 最大3か月照会可能 - <例> 202401 |
| `endMonth` | String | Required | 照会終了月(yyyyMM) - 最大3か月照会可能 - <例> 202403 |
| `contractTypeCode` | String | Optional | 契約タイプコード |
| `contractStatusCode` | String | Optional | 契約状態コード - `NOML` \| `NLEND` - `NOML`: 正常 - `NLEND`: 終了 |
| `regionCode` | String | Optional | リージョンコード - [getRegionList](/docs/ja/platform-region-getregionlist)アクションを通じて取得可能 |
| `responseFormatType` | String | Optional | レスポンス結果の形式 - `xml`(デフォルト) \| `json` |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location 'https://billingapi.apigw.ntruss.com/billing/v1/cost/getContractUsageList?startMonth=202402&endMonth=202404'
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの詳細は、[ContractList](/docs/ja/common-vapidatatype-contractlist)をご参照ください。

### レスポンスステータスコード

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
<?xml version="1.0" encoding="UTF-8"?>
<getContractUsageListResponse>
    <requestId>e05dd3ef-****-****-****-bb973f080144</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <contractList>
        <contract>
            <memberNo>******</memberNo>
            <contractNo>9294191</contractNo>
            <conjunctionContractNo></conjunctionContractNo>
            <contractType>
                <code>VSVR</code>
                <codeName>Server (VPC)</codeName>
            </contractType>
            <contractStatus>
                <code>NOML</code>
                <codeName>Normal</codeName>
            </contractStatus>
            <contractStartDate>2022-05-17T14:57:54+0900</contractStartDate>
            <contractEndDate>2999-12-31T23:59:59+0900</contractEndDate>
            <instanceName>nas-linux</instanceName>
            <regionCode>KR</regionCode>
            <platformType>
                <code>VPC</code>
                <codeName>VPC</codeName>
            </platformType>
            <contractProductList>
                <contractProduct>
                    <contractProductSequence>1</contractProductSequence>
                    <beforeContractProductSequence></beforeContractProductSequence>
                    <productCode>SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002</productCode>
                    <priceNo>10525</priceNo>
                    <promiseNo></promiseNo>
                    <instanceNo>11025677</instanceNo>
                    <productItemKind>
                        <code>VSVR</code>
                        <codeName>Server (VPC)</codeName>
                    </productItemKind>
                    <productRatingType>
                        <code>VSVR</code>
                        <codeName>Server (VPC) Usage</codeName>
                    </productRatingType>
                    <serviceStatus>
                        <code>NOML</code>
                        <codeName>Normal</codeName>
                    </serviceStatus>
                    <serviceStartDate>2022-05-17T14:57:54+0900</serviceStartDate>
                    <serviceEndDate>2999-12-31T23:59:59+0900</serviceEndDate>
                    <productSize>0</productSize>
                    <productCount>0</productCount>
                    <usageList>
                        <usage>
                            <meteringType>
                                <code>VSVR</code>
                                <codeName>Server (VPC) Usage</codeName>
                            </meteringType>
                            <useMonth>202404</useMonth>
                            <usageQuantity>864000</usageQuantity>
                            <unit>
                                <code>USAGE_SEC</code>
                                <codeName>Usage time (per second)</codeName>
                            </unit>
                            <userUsageQuantity>240</userUsageQuantity>
                            <userUnit>
                                <code>HOUR</code>
                                <codeName>Hour(s)</codeName>
                            </userUnit>
                        </usage>
                    </usageList>
                </contractProduct>
            </contractProductList>
        </contract>
    </contractList>
</getContractUsageListResponse>
```