---
updatedAt: 2026-10-31T11:40:54.000Z
agentTools:
  projectIndex: https://docs.link.getmoneytree.com/llms.txt
---

# ポイント口座

> 📘 必要なOAuthスコープ: `points_read`

すべてのポイント口座のリストを取得します。


# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "title": "ポイント口座",
    "version": "1.0.0",
    "description": "",
    "contact": {
      "name": "Moneytree Link Support",
      "email": "link-support@moneytree.jp"
    }
  },
  "servers": [
    {
      "url": "https://jp-api-staging.getmoneytree.com",
      "description": "日本の検証環境"
    },
    {
      "url": "https://jp-api.getmoneytree.com",
      "description": "日本の本番環境"
    }
  ],
  "tags": [
    {
      "name": "ポイント",
      "description": "ポイント"
    }
  ],
  "paths": {
    "/link/points/accounts.json": {
      "get": {
        "tags": [
          "ポイント"
        ],
        "security": [
          {
            "oauth2": [
              "points_read"
            ]
          }
        ],
        "operationId": "get-link-points-accounts",
        "summary": "ポイント口座",
        "description": "> 📘 必要なOAuthスコープ: `points_read`\n\nすべてのポイント口座のリストを取得します。\n",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "ページネーション用のページ番号です。\n返された結果のページオフセットを設定します。ページ番号は、1 から始まります。\n",
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1,
              "maximum": 100000
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "description": "1ページあたりの件数。",
            "schema": {
              "type": "integer",
              "default": 500,
              "minimum": 1,
              "maximum": 500
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "point_accounts"
                  ],
                  "properties": {
                    "point_accounts": {
                      "type": "array",
                      "items": {
                        "allOf": [
                          {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "integer",
                                "format": "int64",
                                "description": "ポイント口座ID。",
                                "example": 234789
                              },
                              "account_group": {
                                "type": "integer",
                                "format": "int64",
                                "description": "アカウントが属してるグループ。アカウントグループは金融機関のサイトでは１ユーザとして表示される。",
                                "example": 133344
                              },
                              "account_type": {
                                "type": "string",
                                "description": "口座タイプ。ポイント口座の場合、常に`point`です。\n",
                                "example": "point"
                              },
                              "currency": {
                                "type": "string",
                                "description": "ISO4217に基づく通貨のコード。ポイント口座の場合、通常はポイントシステムの通貨表現です。"
                              },
                              "institution_entity_key": {
                                "type": "string",
                                "maxLength": 255,
                                "description": "アカウントが属する金融機関（institution）のentity key（上記のIDの代わりに、これを利用してください。）金融機関の合併などで、アカウントのinstitution_entity_keyが変わることがあるため、APIを読み取ったたびに新しい値があれば格納した方がいい。"
                              },
                              "institution_account_name": {
                                "type": "string",
                                "maxLength": 255,
                                "description": "金融機関（institution）の口座名。例）積立貯金。"
                              },
                              "nickname": {
                                "type": "string",
                                "maxLength": 255,
                                "description": "マネーツリー内でユーザーが口座につけた名称。ユーザーがニックニームを個別に付けていない場合、`institution_account_name`と同じ値が返却されます。"
                              },
                              "current_balance": {
                                "type": "number",
                                "format": "double",
                                "description": "現在のポイント残高。",
                                "nullable": true
                              }
                            },
                            "required": [
                              "id",
                              "account_group",
                              "account_type",
                              "currency",
                              "institution_entity_key",
                              "institution_account_name",
                              "nickname",
                              "current_balance"
                            ]
                          },
                          {
                            "type": "object",
                            "properties": {
                              "aggregation_state": {
                                "type": "string",
                                "minLength": 0,
                                "maxLength": 255,
                                "enum": [
                                  "success",
                                  "running",
                                  "error"
                                ],
                                "description": "最新のデータの取得状況。値と意味は下記参照。"
                              },
                              "aggregation_status": {
                                "type": "string",
                                "minLength": 0,
                                "maxLength": 255,
                                "enum": [
                                  "success",
                                  "running.auth",
                                  "running.data",
                                  "running.intelligence",
                                  "suspended.missing-answer.auth.security",
                                  "suspended.missing-answer.auth.otp",
                                  "suspended.missing-answer.auth.captcha",
                                  "suspended.missing-answer.auth.puzzle",
                                  "inactive",
                                  "auth.creds.security.invalid",
                                  "auth.creds.otp.invalid",
                                  "auth.creds.captcha.invalid",
                                  "auth.creds.puzzle.invalid",
                                  "auth.creds.certificate.required",
                                  "guest.intervention.required",
                                  "auth.creds.invalid",
                                  "auth.creds.locked.temporary",
                                  "auth.creds.locked.permanent",
                                  "error.permanent",
                                  "error.temporary",
                                  "error.session",
                                  "error.network",
                                  "error.service.unavailable",
                                  "error.unsupported",
                                  "unknown"
                                ],
                                "description": "最新のデータの取得状況。\"aggregation_state\"より詳細な内容。値と意味はこちらを参照。\nより詳細な説明は、[aggregation_statusの一覧](https://docs.link.getmoneytree.com/docs/aggregation_status_list)ガイドを参照してください。\n"
                              },
                              "last_aggregated_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "データを取得した前回時刻"
                              },
                              "last_aggregated_success": {
                                "type": "string",
                                "format": "date-time",
                                "description": "データを正常に取得できた前回時刻",
                                "nullable": true
                              }
                            },
                            "required": [
                              "aggregation_state",
                              "aggregation_status",
                              "last_aggregated_at",
                              "last_aggregated_success"
                            ]
                          },
                          {
                            "type": "object",
                            "properties": {
                              "created_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "マネーツリーに登録された時刻。",
                                "example": "2023-06-01T01:03:00+09:00"
                              },
                              "updated_at": {
                                "type": "string",
                                "format": "date-time",
                                "description": "最終更新時刻（マネーツリーやユーザーによる変更等により更新されます）",
                                "example": "2023-06-01T03:15:00+09:00"
                              }
                            },
                            "required": [
                              "created_at",
                              "updated_at"
                            ]
                          }
                        ]
                      }
                    }
                  }
                },
                "example": {
                  "point_accounts": [
                    {
                      "id": 1506038,
                      "account_type": "point",
                      "aggregation_state": "success",
                      "last_aggregated_at": "2015-04-13T12:07:52+09:00",
                      "last_aggregated_success": "2015-04-13T12:07:52+09:00",
                      "aggregation_status": "success",
                      "created_at": "2014-08-06T18:44:42+09:00",
                      "updated_at": "2014-08-06T18:44:42+09:00",
                      "currency": "XPO",
                      "institution_entity_key": "starbucks_card",
                      "institution_account_name": "スターバックス",
                      "nickname": "スターバックス",
                      "current_balance": 9000,
                      "account_group": 1
                    },
                    {
                      "id": 1022901,
                      "account_type": "point",
                      "aggregation_state": "success",
                      "last_aggregated_at": "2015-04-13T12:07:52+09:00",
                      "last_aggregated_success": "2015-04-13T12:07:52+09:00",
                      "aggregation_status": "success",
                      "created_at": "2014-08-06T18:44:42+09:00",
                      "updated_at": "2014-08-06T18:44:42+09:00",
                      "currency": "XPO",
                      "institution_entity_key": "jal_mileage_bank",
                      "institution_account_name": "JALマイル",
                      "nickname": "JAL Miles",
                      "current_balance": 12040,
                      "account_group": 2
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "APIに対して行われたリクエストが無効である場合に返されます。\nこれは通常、送信されたデータが検証を通過しなかったことが原因です。\n"
          },
          "401": {
            "description": "有効なアクセストークンを持っていない場合に返されます。"
          },
          "403": {
            "description": "持っているアクセストークンが有効であるものの、本APIで必要とされるスコープが付与されていない時に返却されます。"
          },
          "429": {
            "description": "アプリケーションが多くのリクエストを送信し、レート制限を受けている場合に返されます。\n[APIレート制限は何か、どのように対処するのか？](https://docs.link.getmoneytree.com/docs/faq-rate-limiting)もご覧ください。\n"
          },
          "500": {
            "description": "原因不明の内部サーバーエラーが発生した場合に返されます。"
          },
          "503": {
            "description": "Moneytreeサービスがメンテナンス中の場合に返されます。まれに、一時的な過負荷など、メンテナンス以外の理由で返される場合もあります。"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "description": "MT LINK APIは、OAuth 2.0のスコープ機能（アクセスが可能な範囲を制限機能）により、利用者のデータへのアクセスを制限しております。\n",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "/oauth/authorize",
            "tokenUrl": "/oauth/token",
            "scopes": {
              "guest_read": "Moneytreeアカウントの基本情報（メールアドレス、言語、地域）の閲覧",
              "accounts_read": "Moneytreeに登録している銀行口座、クレジットカード、デビットカード、電子マネーの名称、口座の種別、残高の閲覧",
              "transactions_read": "Moneytreeに登録している銀行口座、クレジットカード、デビットカード、電子マネーの明細の閲覧",
              "transactions_write": "Moneytreeに登録している銀行口座、クレジットカード、デビットカード、電子マネーの明細のカテゴリやメモの編集",
              "request_refresh": "Moneytreeに登録している金融サービスの資産情報の取得",
              "investment_accounts_read": "Moneytreeに登録している投資用口座（投資信託、株式、確定拠出年金）の名称、口座の種別、残高の閲覧",
              "investment_transactions_read": "Moneytreeに登録している保有銘柄の明細の閲覧",
              "points_read": "Moneytreeに登録しているポイントの名称、残高、明細の閲覧",
              "life_insurance_read": "Moneytreeに登録している生命保険の契約内容の閲覧"
            }
          },
          "clientCredentials": {
            "tokenUrl": "/oauth/token",
            "scopes": {
              "guest_read": "Moneytreeアカウントの基本情報（メールアドレス、言語、地域）の閲覧",
              "accounts_read": "Moneytreeに登録している銀行口座、クレジットカード、デビットカード、電子マネーの名称、口座の種別、残高の閲覧",
              "transactions_read": "Moneytreeに登録している銀行口座、クレジットカード、デビットカード、電子マネーの明細の閲覧",
              "transactions_write": "Moneytreeに登録している銀行口座、クレジットカード、デビットカード、電子マネーの明細のカテゴリやメモの編集",
              "request_refresh": "Moneytreeに登録している金融サービスの資産情報の取得",
              "investment_accounts_read": "Moneytreeに登録している投資用口座（投資信託、株式、確定拠出年金）の名称、口座の種別、残高の閲覧",
              "investment_transactions_read": "Moneytreeに登録している保有銘柄の明細の閲覧",
              "points_read": "Moneytreeに登録しているポイントの名称、残高、明細の閲覧",
              "life_insurance_read": "Moneytreeに登録している生命保険の契約内容の閲覧"
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": false
  }
}
```