/api/v2/server-side-api/vc/transactions/ 仮想通貨トランザクションの一覧を取得する
プロファイルの仮想通貨トランザクション履歴を新しい順に返します。結果はカーソルページネーションを使用します: レスポンスに pagination.next_cursor が null でない値で含まれている場合、それを cursor クエリパラメータとして渡すことで次のページを取得できます。
Query parameters
履歴を単一の仮想通貨コードでフィルタリングします。
前のレスポンスで pagination.next_cursor として返された不透明なページネーションカーソル。最初のページを取得するには省略してください。
1ページあたりに返すトランザクションの最大件数。デフォルトは50件です。
Header parameters
お客様のシステムにおける顧客の一意のID。adapty-customer-user-id または adapty-profile-id のいずれかが必須です。
お客様のシステムにおけるプロファイルの一意のID。匿名プロファイルを扱う場合に最適な選択肢です。adapty-customer-user-id または adapty-profile-id のいずれかが必須です。
Responses
トランザクション履歴が正常に返されました
Schema
プロファイルの仮想通貨トランザクション履歴のページネーションリスト。
トランザクションの一意のID。
トランザクションのソース。store_purchase、subscription_renewal、trial_start、api_transaction、dashboard_transaction、refund、または expiry のいずれか。
このトランザクションに記録された通貨ごとの残高変動。
バーチャル通貨コード。
残高に適用された符号付き変化量。正の値はクレジット、負の値はデビットを表します。
このトランザクション適用後の通貨残高。
トランザクションに保存されたキーと値のペア（存在する場合）。
トランザクションが記録された日時。
次のページのための不透明なカーソルです。さらに結果を取得するには、cursor クエリパラメータとして渡してください。これ以上ページがない場合は null になります。
Example
{
"data": [
{
"transaction_id": "0190e8a4-1c2b-7def-8abc-2c1a4b6d8e90",
"transaction_type": "api_transaction",
"items": [
{
"currency_code": "COINS",
"amount": 500,
"balance_after": 12950
}
],
"metadata": {
"reason": "promo_bonus"
},
"created_at": "2026-05-23T10:30:00Z"
},
{
"transaction_id": "0190e7b2-9a44-7c10-bb31-7d2e9f0a1c55",
"transaction_type": "store_purchase",
"items": [
{
"currency_code": "COINS",
"amount": 1000,
"balance_after": 12450
}
],
"created_at": "2026-05-22T18:05:12Z"
},
{
"transaction_id": "0190e5c0-3f18-7b9a-9e6d-44a1c8b27e03",
"transaction_type": "subscription_renewal",
"items": [
{
"currency_code": "GEMS",
"amount": 200,
"balance_after": 3280
}
],
"created_at": "2026-05-20T09:00:00Z"
}
],
"pagination": {
"next_cursor": "MjAyNi0wNS0yMFQwOTowMDowMFowMTkwZTVjMC0zZjE4LTdiOWEtOWU2ZC00NGExYzhiMjdlMDM="
}
}不正なリクエスト。cursor の値が無効です（error_code は invalid_cursor）。
Schema
エラーの発生源
エラーメッセージの配列
エラーの短い名称
HTTPステータスコード
認証エラー。APIキーが見つからないか無効です。
Schema
エラーの発生源
エラーメッセージの配列
エラーの短い名称
HTTPステータスコード
禁止。このアプリでは仮想通貨のServer APIが有効になっていません。
Schema
エラーの発生源
エラーメッセージの配列
エラーの短い名称
HTTPステータスコード
プロファイルが見つかりません。
Schema
エラーの発生源
エラーメッセージの配列
エラーの短い名称
HTTPステータスコード
内部サーバーエラー