API v1.0 - Public Beta

退職金最適化シミュレーター API

退職金・iDeCo・年金の受取戦略を税制に基づきシミュレーションするAPI。無料で利用可能です。

Start Here

まず読む順番を決める

APIの仕様確認だけで終わらせず、シミュレーション・学習・レポートへ自然に移動できます。

シミュレーション

受取パターンを実際に比べる

学習ガイド

10年ルールと退職所得控除を整理

レポート

実態データとケーススタディを読む

ニュース

制度変更と更新情報を確認する

# Quick Start

curl

curl "https://www.taisyoku.xyz/api/v1/simulate?retirement_bonus_man=2000&years_of_service=30&ideco_amount_man=500&ideco_years=20&current_age=58"

Response

{
  "status": "ok",
  "data": {
    "retirement_bonus": {
      "gross_man": 2000,
      "deduction_man": 1500,
      "taxable_man": 250,
      "tax_man": 51.2,
      "net_man": 1948.8
    },
    "ideco": {
      "gross_man": 500,
      "deduction_man": 400,
      "taxable_man": 50,
      "tax_man": 10.2,
      "net_man": 489.8
    },
    "pension": {
      "annual_man": 180,
      "monthly_man": 15,
      "tax_annual_man": 12.5,
      "net_annual_man": 167.5
    },
    "optimal_strategy": {
      "recommendation": "iDeCoを5年ずらして65歳で受取",
      "total_tax_saving_man": 82.3,
      "explanation": "退職所得控除を退職金とiDeCoで分けて活用することで、税負担を最小化できます。"
    },
    "currency": "JPY"
  },
  "meta": {
    "api_version": "1.0",
    "source": "https://www.taisyoku.xyz"
  }
}

# Authentication

認証不要。APIキーなしで利用できます。すべてのエンドポイントはパブリックアクセス可能です。

# Endpoints

GETPOST/api/v1/simulate

退職金・iDeCo・年金の最適受取シミュレーションを実行します。GETはクエリパラメータ、POSTはJSONボディで送信。

GET/api/v1/tax-tables

退職所得控除額・所得税率の早見表データを取得します。

# Parameters

Name	Type	Required	Description	Example
`retirement_bonus_man`	number	required	退職金額（万円）	2000
`years_of_service`	number	required	勤続年数	30
`ideco_amount_man`	number	optional	iDeCo受取予定額（万円）	500
`ideco_years`	number	optional	iDeCo加入年数	20
`current_age`	number	required	現在の年齢	58
`retirement_age`	number	optional	退職予定年齢（デフォルト: 60）	60
`public_pension_man`	number	optional	公的年金の年額（万円）	180
`pension_receiving_years`	number	optional	年金受給予定年数	25

利用シーン

退職前の事前試算

自社サイトや社内システムの前段で、受取方法の比較ロジックを確認できます。

学習・研究用途

算出方法論や制度解説ページと合わせて、税制の仕組みを体系的に参照できます。

次に読む場所