--- agentTools: projectIndex: https://docs.link.getmoneytree.com/llms.txt --- # 法人口座の取引明細 > 📘 必要なOAuthスコープ: `transactions_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/corporate/accounts/{account_id}/transactions.json": { "get": { "tags": [ "法人口座" ], "security": [ { "oauth2": [ "transactions_read" ] } ], "operationId": "get-link-corporate-accounts-transactions", "summary": "法人口座の取引明細", "description": "> 📘 必要なOAuthスコープ: `transactions_read`\n\n法人口座の取引明細を返します。\n", "parameters": [ { "name": "account_id", "in": "path", "required": true, "description": "アカウントID", "schema": { "type": "integer", "format": "int64" }, "example": 1048 }, { "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 } }, { "name": "sort_key", "in": "query", "required": false, "description": "取引明細のソート順のキー\n`sort_key`の値が渡されない場合、デフォルトでデータベースの`id`キーが使用される。\n`sort_key`の使用はレスポンスタイムに影響を与える可能性があるため、必要なときだけ使用することを推奨する。\nソート順のキーに`date`を指定すると、データベースは取引の`date`でソートされます（Moneytree が取得した日付ではなく、実際の取引の日付です）。\n", "schema": { "type": "string", "default": "id" }, "example": "date" }, { "name": "sort_by", "in": "query", "required": false, "description": "ソート順は、昇順と降順で指定できます。\n`asc` → 昇順（指定がない場合、昇順になります）。\n`desc` → 降順。\n", "schema": { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] }, "example": "desc" }, { "name": "since", "in": "query", "required": false, "description": "入力した値以降に更新された（`updated_at`）レコードを取得します。\n", "schema": { "type": "string", "format": "date", "example": "2020-11-28", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, { "name": "start_date", "in": "query", "required": false, "description": "取引明細の開始日。指定する場合、`end_date`も必須です。\n`since`パラメータと同時に指定した場合、`since`パラメータが優先されます。\n[`since`と`start_date`/`end_date`の使い分けについて。](https://docs.link.getmoneytree.com/docs/api-notes-api#start%E3%80%81end%E3%81%A8since%E3%81%AE%E5%BC%95%E6%95%B0%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)\n", "schema": { "type": "string", "format": "date", "example": "2020-11-28", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, { "name": "end_date", "in": "query", "required": false, "description": "取引明細の終了日。指定する場合、`start_date`も必須です。\n`since`パラメータと同時に指定した場合、`since`パラメータが優先されます。\n[`since`と`start_date`/`end_date`の使い分けについて。](https://docs.link.getmoneytree.com/docs/api-notes-api#start%E3%80%81end%E3%81%A8since%E3%81%AE%E5%BC%95%E6%95%B0%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)\n", "schema": { "type": "string", "format": "date", "example": "2020-11-28", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "transactions" ], "properties": { "transactions": { "type": "array", "items": { "allOf": [ { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "description": "トランザクションID（システム全体でユニークな値。例えば、同じ金融機関の口座を同じ認証情報で2回登録した場合、各エンティティには異なるIDが付与されます。）", "example": 234789 }, "amount": { "type": "number", "format": "currency", "description": "取引金額。", "example": 10 }, "date": { "type": "string", "format": "date-time", "description": "取引日。", "example": "2023-06-01T00:00:00+00:00" }, "description_guest": { "type": "string", "minLength": 0, "maxLength": 255, "nullable": true, "description": "お客様によって入力された取引の内容。", "example": "Morning Coffee" }, "description_pretty": { "type": "string", "minLength": 0, "maxLength": 255, "nullable": true, "description": "マネーツリーによって補正された取引の内容。", "example": "Coffee" }, "description_raw": { "type": "string", "minLength": 0, "maxLength": 255, "nullable": true, "description": "編集されていない取引の内容（生データ）。\n明細名（摘要欄）の情報については、銀行APIの仕様により桁数の制限があります。詳細については、公表されている各銀行のAPI仕様をご確認ください。\n", "example": "Coffee" }, "account_id": { "type": "integer", "format": "int64", "description": "アカウントID。", "example": 66780 }, "category_id": { "type": "integer", "format": "int64", "description": "取引明細のカテゴリーID。", "example": 887755 }, "attributes": { "type": "object", "description": "このオブジェクトは、トランザクションによっては空であることもある。\nこの属性オブジェクトの下にあるプロパティはオプションです。\n返されるプロパティは、アカウントのサブタイプに依存します。\n", "properties": { "fx_base_currency": { "type": "string", "example": "USD", "description": "外貨建てクレジットカード取引の場合、使用通貨。" }, "fx_base_amount": { "type": "number", "format": "float", "example": 1234.5, "description": "外貨でのクレジットカード取引の場合、その現地通貨での金額。" }, "authorization_code": { "type": "string", "example": "123456", "description": "デビットカードの場合、取引の認証コードで。通常は6桁の数字。" }, "balance": { "type": "number", "format": "float", "example": 100000000, "description": "銀行口座の場合は、この取引後の残高。" }, "is_revolving": { "type": "boolean", "description": "この明細がリボ払いの場合、`true`となる。" }, "is_bonus": { "type": "boolean", "description": "この明細がボーナス払いの場合、`true`となる。" }, "is_cash_advance": { "type": "boolean", "description": "この明細がキャッシングであった場合（例：クレジットカードを使って現金を引き出した場合）、`true`となる。" }, "installment_count": { "type": "integer", "example": 2, "description": "この明細の分割払い回数。分割払いを利用しなかったことを示すため「1」となる場合もある。　" }, "creation_date": { "description": "銀行等の金融機関において、実質的な資金移動が発生した日付。銀行APIのデータソースから取得した値を反映しています。YYYY-MM-DD 形式。", "example": "2026-02-24", "type": "string", "format": "date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "settlement_date": { "description": "銀行等の金融機関において、会計処理上の決済が完了した日として扱われる日付。銀行APIのデータソースから取得した値を反映しています。YYYY-MM-DD 形式。", "example": "2026-02-25", "type": "string", "format": "date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "remitter_code": { "type": "string", "example": "1234567891", "description": "振込依頼人コードとは、銀行などの金融機関が、総合振込や給与振込を行う法人・事業主に割り当てる10桁の固有番号です。金融機関により「会社コード」「委託者コード」と発行されている場合もあります。" } } } }, "required": [ "id", "amount", "date", "description_guest", "description_pretty", "description_raw", "account_id", "category_id", "attributes" ] }, { "type": "object", "properties": { "expense_type": { "type": "integer", "enum": [ 0, 1, 2 ], "deprecated": true, "description": "トランザクションの種類。\n0 = 不明 (私用と仮定)\n1 = 私用\n2 = 仕事\n" }, "predicted_expense_type": { "type": "integer", "enum": [ 0, 1, 2 ], "deprecated": true, "description": "トランザクションの種類。\n0 = 不明 (私用と仮定)\n1 = 私用\n2 = 仕事\n" }, "data_source": { "type": "string", "enum": [ "institution" ], "deprecated": true } }, "required": [ "expense_type", "predicted_expense_type", "data_source" ] }, { "type": "object", "properties": { "transaction_type": { "type": "string", "enum": [ null ], "nullable": true, "deprecated": true, "description": "常に `null` を返します。" } }, "required": [ "transaction_type" ] }, { "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" ] } ] } } } } } } }, "400": { "description": "APIに対して行われたリクエストが無効である場合に返されます。\nこれは通常、送信されたデータが検証を通過しなかったことが原因です。\n" }, "401": { "description": "有効なアクセストークンを持っていない場合に返されます。" }, "403": { "description": "持っているアクセストークンが有効であるものの、本APIで必要とされるスコープが付与されていない時に返却されます。" }, "404": { "description": "要求されたエンティティが見つからない場合に返されます。" }, "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, "proxy-enabled": true }, "_id": { "buffer": { "0": 106, "1": 152, "2": 222, "3": 177, "4": 149, "5": 242, "6": 192, "7": 24, "8": 245, "9": 247, "10": 161, "11": 54 } } } ```