---
title: "決済売上統計照会"
slug: "game-gamepot-purchasestatistics"
updated: 2026-09-17T09:57:53Z
published: 2026-09-17T09:57:53Z
canonical: "api.ncloud-docs.com/game-gamepot-purchasestatistics"
---

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

# 決済売上統計照会

**当該コンテンツは、ローカリゼーションサービスを準備しております。早急にローカライズサービスをご提供できるよう、努めております。**

## 要請

```
GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/purchase/statistics?startDate={startDate}&endDate={endDate}&currency={currency}
```

| 項目 | タイプ | 必須かどうか | 説明 | 備考 |
| --- | --- | --- | --- | --- |
| projectId | String | O | GamePot SDK의 projectId |  |
| startDate | String | X | 決済売上統計検索開始日 | `YYYY-MM-DD` |
| endDate | String | X | 決済売上統計検索終了日 | `YYYY-MM-DD` |
| currency | String | X | 決済売上統計通貨検索(all...) | ISO 4217の規定に従っています。 |

          参考

          

Queryで startDate, endDateを入れなければ、最近30日間のデータを照会します。

### 要請Header

| Header名 | 必須かどうか | 説明 |
| --- | --- | --- |
| x-api-key | O | GamePotで発行する認証key |
| accept-language | X | 使用言語 |

## 応答

| 필드명 | 타입 | 설명 |
| --- | --- | --- |
| status | Int | 結果値 (1: 成功) |
| totalCount | Int | 検索結果値数 |
| currencyList | String | 通貨リスト ISO 4217の規定に従っています。 |
| date | String | 統計日付 |
| count | String | 売上統計金額 |

## 例示

### 要請例

```

curl --request GET \
  --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/purchase/statistics?startDate=2020-05-01&endDate=2020-06-01&currency=all \
  --header 'accept-language: ko' \
  --header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'
```

### 応答例

```
"status": 1,
  "result": {
    "totalCount": 13,
    "currencyList": [
      "KRW",
      "USD"
    ],
    "edges": [
      {
        "node": {
          "date": "2020-05-01",
          "count": 0
        }
      },
      {
        "node": {
          "date": "2020-05-02",
          "count": 0
        }
      },

...

      {
        "node": {
          "date": "2020-05-13",
          "count": 4008857.31
        }
      }
    ]
  }
}
```

## エラーコード

Gamepot Open APIリクエスト時に発生する共通エラーコードです。

| parameter | 説明 |
| --- | --- |
| status | エラーコード(1: 成功、失敗時Error code参考) |
| message | エラー詳細説明 |

| エラーコード | 説明 |
| --- | --- |
| -1 | ダッシュボードにないkeyを使用した場合 |
| -2 | ダッシュボードのkeyとheaderのkeyが異なる場合 |
| -3 | ダッシュボードで削除したkeyを使用した場合 |
| -4 | ダッシュボードで未使用に処理されたkeyを使用した場合 |
| -5 | keyが切れた場合 |
| -6 | プロジェクトIDがない場合 |

```
{
  "status": -6,
  "message": "projectId was wrong."
}
```

決済売上統計照会API要請時に発生するエラーコードです。

| 오류 코드 | 설명 |
| --- | --- |
| -11 | startDate値のフォーマットが正しくない場合, `YYYY-MM-DD` 形式のみ可能 |
| -12 | endDate 値のフォーマットが正しくない場合, `YYYY-MM-DD` 形式のみ可能 |