クラウド家計簿ソフト「マネーフォワード」の開発者向けAPIのドキュメントです。現在は、クローズドAPIとして、特定のパートナー企業様へ提供をしております。
本APIは継続開発中であり、予告なく変更等が入る可能性があります。
- ユーザー情報の取得
- 自動取得金融機関情報の取得
- 口座情報の取得・編集
- 入出金情報の取得・編集
- 資産情報の取得
- 取引情報の取得
OAuth2: Authorization Code Flowに基づくOpenID Connect
要求のパラメーターは、それぞれ
- パス
- クエリー
- ヘッダー
- (POSTメソッド時の)本文
のうちの決められた場所に記載して下さい。本文のパラメーターはJSON形式で受け取ります。
日時、日付のパラメーターの値には ISO-8601 拡張形式を推奨します。
-
例 (2014年04月01日00時00分01秒):
2014-04-01T00:00:01+09:00 -
例 (2014年04月01日):
2014-04-01
他の 2017/04/01 などの形式も現状では使用可能ですが、将来のバージョンアップにより使用出来なくなるかも知れません。
名前の末尾が [] になっているパラメーターは、1回の要求で繰り返し使って複数の値を指定することができます。
-
例:
https://moneyforward.com/api/v1/accounts?service_category_ids[]=1&service_category_ids[]=2&page=1
成功時には200を、エラー時には 4xx 乃至 5xx (x は数字) をステータスコードとして返します。
API の使用には、それに先立って、ユーザーの認可を得、さらにアクセストークンを得るという手順が必要です。発行されるアクセストークンは、APIへのアクセスの度に必要です。アクセストークンは、発行から一定時間が過ぎると使えなくなります。発行されたアクセストークンの有効期限が切れたときは、再びユーザーの認可を受けるという手順を踏まずに、再びアクセストークンを得ることができます。
| メソッド | URI | |
|---|---|---|
| ユーザーの認可を得る | GET または POST | /oauth/authorize |
| アクセストークンを得る | POST | /oauth/v2/token |
| アクセストークンを再び得る | POST | /oauth/v2/token |
| メソッド | URI | 必要な権限(スコープ) | |
|---|---|---|---|
| ユーザーの認証情報や電子メールを得る | GET または POST | /oauth/userinfo | openid または openid email |
| ユーザーの登録状況を得る | GET | /api/v1/user | なし |
| ユーザーのSSOトークンを登録する | POST | /api/v1/sso_tokens | manage_sso |
| ユーザーのデモグラフィック情報を閲覧する | GET | /api/v1/profile | profile |
| ユーザーの登録を削除する | DELETE | /api/v1/user | 非公開 |
| メソッド | URI | 必要な権限(スコープ) | |
|---|---|---|---|
| 金融機関の全ての分類を得る | GET | /api/v1/service_categories | なし |
| マネーフォワードで口座を登録可能な全ての金融機関を得る | GET | /api/v1/services | なし |
| マネーフォワードで登録可能な特定の金融機関のログインに必要な入力項目を得る | GET | /api/v1/services/:id | なし |
| マネーフォワードが金融機関から情報を取得しようとする際に生じうる全てのエラーの種類を得る | GET | /api/v1/aggregation_errors | なし |
| メソッド | URI | 必要な権限(スコープ) | |
|---|---|---|---|
| 口座を登録する | POST | /api/v1/accounts | manage_accounts |
| 特定の口座連携を解除する | DELETE | /api/v1/accounts/:id | manage_accounts |
| 特定の口座の登録内容を書き換える | PATCH または PUT | /api/v1/accounts/:id | manage_accounts |
| 特定の口座のログインに必要な追加の入力項目を登録する | POST | /api/v1/additional_requests | manage_accounts |
| 特定の口座のログインに必要な追加の入力項目の答えを編集する | PATCH または PUT | /api/v1/additional_requests/:id | manage_accounts |
| 全ての口座の情報をマネーフォワードに金融機関から再取得させる | POST | /api/v1/accounts/acquire | acquire_accounts |
| 特定の口座の情報をマネーフォワードに金融機関から再取得させる | POST | /api/v1/accounts/:id/acquire | acquire_accounts |
| 全ての口座の取得状況や資産額合計を得る | GET | /api/v1/accounts | accounts または manual_accounts |
| 特定の口座の取得状況や資産額合計、ログインに必要な入力項目を得る | GET | /api/v1/accounts/:id | accounts |
| メソッド | URI | 必要な権限(スコープ) | |
|---|---|---|---|
| 入出金の全ての大分類(及びその中のユーザー作成の中分類)を得る | GET | /api/v1/transactions/categories | transactions |
| 入出金項目を登録する | POST | /api/v1/transactions | manage_transactions |
| 特定の入出金項目の情報を書き換える | PATCH または PUT | /api/v1/transactions/:id | manage_transactions |
| 全ての入出金記録を得る | GET | /api/v1/transactions | transactions |
| 要求の日を含む期間の収支を、日曜始まりの週または月ごとに得る | GET | /api/v1/derived/transaction_histories | transactions |
| 日曜始まりの週または月の収支を、資産の分類ごとに得る | GET | /api/v1/derived/transaction_summaries | transactions |
| メソッド | URI | 必要な権限(スコープ) | |
|---|---|---|---|
| 資産の全ての大分類(及びその中の中分類)を得る | GET | /api/v1/asset_classes | なし |
| 資産の全ての中分類を得る | GET | /api/v1/asset_subclasses | なし |
| 全ての資産を得る | GET | /api/v1/user_assets | assets |
| 特定の資産を得る | GET | /api/v1/user_assets/:id | assets |
| 全ての資産の履歴を得る | GET | /api/v1/user_asset_histories | assets |
| 全ての大分類ごとの資産の合計を得る | GET | /api/v1/user_asset_classes | assets |
| 全ての大分類ごとの資産の合計の履歴を得る | GET | /api/v1/user_asset_class_histories | assets |
| メソッド | URI | 必要な権限(スコープ) | |
|---|---|---|---|
| 全ての約定の履歴を得る | GET | /api/v1/executions | trades_inquiry または crypto_ccy_trades_inquiry |