下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。
- 日時: 2026-11-18 (水) 1:00 – 5:00
- 対象: freee 全サービス(電子公告サービス除く)
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
(10/2)[会計]freee会計 APIにおいて、事業所・ユーザーの
権限ロール追加および品目名の最大長拡張などが行われました。
変更対象API:
GET /api/1/companies – 事業所一覧の取得
GET /api/1/companies/{id} – 事業所の取得
GET /api/1/users/me – ログインユーザーの取得
GET /api/1/users/capabilities – ログインユーザーの権限の取得
GET /api/1/items – 品目一覧の取得
POST /api/1/items – 品目の作成
PUT /api/1/items/code/upsert – 品目の更新(存在しない場合は作成)
GET /api/1/items/{id} – 品目の取得
PUT /api/1/items/{id} – 品目の更新
GET /api/1/deals – 取引(収入・支出)一覧の取得
POST /api/1/deals – 取引(収入・支出)の作成
GET /api/1/deals/{id} – 取引(収入・支出)の取得
PUT /api/1/deals/{id} – 取引(収入・支出)の更新
POST /api/1/deals/{id}/payments – 取引(収入・支出)の支払行の作成
PUT /api/1/deals/{id}/payments/{payment_id} – 取引(収入・支出)の支払行の更新
POST /api/1/deals/{id}/renews – 取引(収入・支出)の+更新の作成
PUT /api/1/deals/{id}/renews/{renew_id} – 取引(収入・支出)の+更新の更新
DELETE /api/1/deals/{id}/renews/{renew_id} – 取引(収入・支出)の+更新の削除
GET /api/1/manual_journals – 振替伝票一覧の取得
POST /api/1/manual_journals – 振替伝票の作成
GET /api/1/manual_journals/{id} – 振替伝票の取得
PUT /api/1/manual_journals/{id} – 振替伝票の更新
変更種別: 破壊的変更なし
変更内容:
事業所一覧・事業所の取得・ログインユーザーの取得APIのレスポンスにおいて、事業所に対するユーザーの権限(role)に以下の値が追加されました。
(10/2)[IT管理]IT管理 APIにおいて、備品属性・備品保管場所・備品利用者の管理エンドポイントが追加されました。
変更対象API:
GET, POST /hub/it_management/asset_attributes – 備品属性の一覧取得・作成
GET, PATCH, DELETE /hub/it_management/asset_attributes/{id} – 備品属性の詳細取得・部分更新・削除
GET, POST /hub/it_management/asset_locations – 備品保管場所の一覧取得・作成
GET, PATCH, DELETE /hub/it_management/asset_locations/{id} – 備品保管場所の詳細取得・部分更新・削除
GET, POST /hub/it_management/assets/{asset_id}/members – 備品利用者の一覧取得・備品へのメンバー割当
GET, PATCH, DELETE /hub/it_management/assets/{asset_id}/members/{id} – 備品利用者の詳細取得・部分更新・削除
GET /hub/it_management/assets – 備品一覧取得
POST /hub/it_management/assets – 備品作成
GET /hub/it_management/assets/{id} – 備品詳細取得
PATCH /hub/it_management/assets/{id} – 備品部分更新
変更種別: 破壊的変更なし
変更内容:
備品属性(asset_attributes)、備品保管場所(asset_locations)、備品利用者(assets/{asset_id}/members)を管理する各種エンドポイントが新設されました。
備品の作成・部分更新APIのリクエストに、任意プロパティ asset_attribute_values(備品属性の値)および asset_location_id(保管場所ID)が追加されました。
備品の一覧取得・作成・詳細取得・部分更新APIのレスポンスに、必須プロパティ asset_attribute_values および asset_location が追加されました。
(10/3)[IT管理]IT管理 APIにおいて、アプリ管理のエンドポイントが追加されました。
変更対象API:
GET /hub/it_management/applications – アプリ一覧取得
GET /hub/it_management/applications/{id} – アプリ詳細取得
PATCH /hub/it_management/applications/{id} – アプリ部分更新
変更種別: 破壊的変更なし
変更内容:
アプリ(applications)の一覧取得、詳細取得、部分更新を行うエンドポイントが新設されました。
(10/5)[会計]フォーム用選択項目情報の取得APIのレスポンス項目追加
変更対象API:
GET /api/1/forms/selectables – フォーム用選択項目情報の取得
変更種別: 破壊的変更なし
変更内容:
レスポンスの account_categories[].account_items[] に、任意プロパティ account_item が追加されました。
(10/6)[IT管理]IT管理 APIにおいて、アプリマスタ・カスタムアプリマスタのエンドポイントが追加されました。
変更対象API:
GET /hub/it_management/application_masters – アプリマスタ一覧取得
GET /hub/it_management/application_masters/{id} – アプリマスタ詳細取得
GET /hub/it_management/custom_application_masters – カスタムアプリマスタ一覧取得
GET /hub/it_management/custom_application_masters/{id} – カスタムアプリマスタ詳細取得
PATCH /hub/it_management/custom_application_masters/{id} – カスタムアプリマスタ部分更新
変更種別: 破壊的変更なし
変更内容:
アプリマスタ(application_masters)の一覧取得・詳細取得、およびカスタムアプリマスタ(custom_application_masters)の一覧取得・詳細取得・部分更新を行うエンドポイントが新設されました。
(10/7)[IT管理]IT管理 APIにおいて、雇用形態の管理エンドポイントが追加されました。
変更対象API:
GET, POST /hub/it_management/employment_types – 雇用形態の一覧取得・作成
GET, PATCH, DELETE /hub/it_management/employment_types/{id} – 雇用形態の詳細取得・部分更新・削除
変更種別: 破壊的変更なし
変更内容:
雇用形態(employment_types)を管理する各種エンドポイントが新設されました。
(10/8)[人事労務]その他手当の作成APIにおける説明の最大長の設定
変更対象API:
POST /api/v1/allowances – その他手当の作成
変更種別: 破壊的変更なし(スキーマ定義の修正)
変更内容:
APIの挙動に変更はありません。
リクエストの allowance.description(説明)に、最大長 255 文字の制約が明記されました。
(10/8)[IT管理]IT管理 APIにおいて、ゲストの管理エンドポイントが追加されました。
変更対象API:
GET, POST /hub/it_management/guests – ゲストの一覧取得・作成
GET, PATCH, DELETE /hub/it_management/guests/{id} – ゲストの詳細取得・部分更新・削除
変更種別: 破壊的変更なし
変更内容:
ゲスト(guests)を管理する各種エンドポイントが新設されました。
(10/9)[会計]経費申請APIにおけるカスタム申請項目・金額計算結果の追加
変更対象API:
POST /api/1/expense_applications – 経費申請の作成
GET /api/1/expense_applications/{id} – 経費申請詳細の取得
PUT /api/1/expense_applications/{id} – 経費申請の更新
POST /api/1/expense_applications/{id}/actions – 経費申請の承認操作
PUT /api/1/expense_applications/{id}/parent_approvable_requests – 経費申請に関連付ける各種申請の更新
変更種別: 破壊的変更なし
変更内容:
経費申請の作成・更新APIのリクエストにおいて、明細(purchase_lines[].expense_application_lines[])に任意プロパティ custom_values(カスタム申請項目の値)が追加されました。
経費申請の各種レスポンスの明細に、任意プロパティ custom_values および amount_calculate_result(金額計算結果)が追加されました。
(10/13)[会計]勘定科目名の最大長拡張および各種レスポンスの nullable 化
変更対象API:
POST /api/1/account_items – 勘定科目の作成
PUT /api/1/account_items/code/upsert – 勘定科目の更新(存在しない場合は作成)
GET /api/1/account_items/{id} – 勘定科目の取得
PUT /api/1/account_items/{id} – 勘定科目の更新
GET /api/1/deals – 取引(収入・支出)一覧の取得
POST /api/1/deals – 取引(収入・支出)の作成
GET /api/1/deals/{id} – 取引(収入・支出)の取得
PUT /api/1/deals/{id} – 取引(収入・支出)の更新
POST /api/1/deals/{id}/payments – 取引(収入・支出)の支払行の作成
PUT /api/1/deals/{id}/payments/{payment_id} – 取引(収入・支出)の支払行の更新
POST /api/1/deals/{id}/renews – 取引(収入・支出)の+更新の作成
PUT /api/1/deals/{id}/renews/{renew_id} – 取引(収入・支出)の+更新の更新
DELETE /api/1/deals/{id}/renews/{renew_id} – 取引(収入・支出)の+更新の削除
POST /api/1/payment_requests – 支払依頼の作成
GET /api/1/payment_requests/{id} – 支払依頼の取得
PUT /api/1/payment_requests/{id} – 支払依頼の更新
POST /api/1/payment_requests/{id}/actions – 支払依頼の承認操作
GET /api/1/purchase_requests – 購買申請一覧の取得
変更種別: 破壊的変更なし
変更内容:
勘定科目APIのレスポンスにおいて、勘定科目名(name)の最大長が 30 文字から 255 文字に拡張されました。
取引の各種レスポンスにおいて、証憑(receipts[])の description および user が nullable に変更されました。
支払依頼の各種レスポンスにおいて、account_type が nullable に変更されました。
購買申請一覧の取得APIのレスポンスにおいて、applicant(申請者)が nullable に変更されました。
(10/13)[IT管理]IT管理 APIにおいて、会社の管理エンドポイントの追加およびアプリ部分更新のリクエスト項目が変更されました。
変更対象API:
GET, POST /hub/it_management/product_companies – 会社の一覧取得・作成
GET, PATCH, DELETE /hub/it_management/product_companies/{id} – 会社の詳細取得・部分更新・削除
PATCH /hub/it_management/applications/{id} – アプリ部分更新
変更種別: 破壊的変更あり(β版)
変更内容:
会社(product_companies)を管理する各種エンドポイントが新設されました。
アプリ部分更新APIのリクエストにおいて、it_management_company_id が削除され、代わりに任意プロパティ product_company_id が追加されました。
(10/14)[人事労務]年末調整APIにおける保険期間の選択肢追加および入力値制約の変更
変更対象API:
GET /api/v1/yearend_adjustments/{year}/employees/{employee_id} – 年末調整の取得
POST /api/v1/yearend_adjustments/{year}/insurances/{employee_id} – 年末調整従業員保険料情報の作成
PUT /api/v1/yearend_adjustments/{year}/insurances/{employee_id}/{id} – 年末調整従業員保険料情報の更新
PUT /api/v1/yearend_adjustments/{year}/dependents/{employee_id} – 年末調整家族情報の更新
変更種別: 破壊的変更なし
変更内容:
保険料情報の保険期間(insurances[].period)に、0ヶ月〜11ヶ月の値が追加されました(リクエスト・レスポンスとも)。
年末調整家族情報の更新APIのリクエストにおいて、dependents[].employment_revenue(給与収入)の最小値が -999999999 から 0 に修正されました(スキーマ定義の修正であり、APIの挙動に変更はありません)。
(10/14)[IT管理]IT管理 APIにおいて、役職・システムアカウントの管理エンドポイントの追加およびアプリ・部署のレスポンス構造が変更されました。
変更対象API:
GET, POST /hub/it_management/positions – 役職の一覧取得・作成
GET, PATCH, DELETE /hub/it_management/positions/{id} – 役職の詳細取得・部分更新・削除
GET, POST /hub/it_management/system_account_owners – システムアカウントの一覧取得・作成
GET, PATCH, DELETE /hub/it_management/system_account_owners/{id} – システムアカウントの詳細取得・部分更新・削除
GET /hub/it_management/applications – アプリ一覧取得
GET /hub/it_management/applications/{id} – アプリ詳細取得
PATCH /hub/it_management/applications/{id} – アプリ部分更新
GET /hub/it_management/departments – 部署一覧取得
POST /hub/it_management/departments – 部署作成
GET /hub/it_management/departments/{id} – 部署詳細取得
PATCH /hub/it_management/departments/{id} – 部署部分更新
GET /hub/it_management/asset_categories – 備品種別一覧取得
POST /hub/it_management/asset_categories – 備品種別作成
GET /hub/it_management/asset_categories/{id} – 備品種別詳細取得
PATCH /hub/it_management/asset_categories/{id} – 備品種別部分更新
変更種別: 破壊的変更あり(β版)
変更内容:
■ アプリ・部署APIのレスポンス構造の変更
アプリおよび部署の各種レスポンスにおいて、会社情報のプロパティ company が削除され、代わりに必須プロパティ product_company が追加されました。
部署作成APIのリクエストに、任意プロパティ product_company_id が追加されました。
■ その他の変更・新機能
役職(positions)およびシステムアカウント(system_account_owners)を管理する各種エンドポイントが新設されました。
備品種別の各種レスポンスに、必須プロパティ asset_attributes(備品属性)が追加されました。
(10/15)[会計]経費申請の金額の自動計算APIが追加されました。
変更対象API:
POST /api/1/expense_applications/amount_calculations – 経費申請の金額の自動計算
変更種別: 破壊的変更なし
変更内容:
経費申請の金額を自動計算するエンドポイントが新設されました。
(10/15)[債権管理]債権管理 APIが公開され、請求一覧取得のエンドポイントが追加されました。
変更対象API:
GET /hub/receivable_management/receivables – 請求一覧取得
変更種別: 破壊的変更なし
変更内容:
債権管理 APIが新たに公開され、請求(receivables)の一覧を取得するエンドポイントが新設されました。
(10/16)[人事労務]年末調整APIにおける所得金額の下限変更
変更対象API:
GET /api/v1/yearend_adjustments/{year}/employees/{employee_id} – 年末調整の取得
PUT /api/v1/yearend_adjustments/{year}/employees/{employee_id} – 年末調整従業員情報の更新
PUT /api/v1/yearend_adjustments/{year}/dependents/{employee_id} – 年末調整家族情報の更新
変更種別: 破壊的変更なし
変更内容:
年末調整の従業員情報および家族情報のレスポンスにおいて、all_other_income(給与以外の所得の合計額)の最小値が 0 から -999999999 に変更され、負の値が返る場合があります。
(10/19)[会計]経費申請APIの外貨対応および支払依頼APIへの関連申請項目の追加
変更対象API:
POST /api/1/expense_applications – 経費申請の作成
GET /api/1/expense_applications/{id} – 経費申請詳細の取得
PUT /api/1/expense_applications/{id} – 経費申請の更新
POST /api/1/expense_applications/{id}/actions – 経費申請の承認操作
PUT /api/1/expense_applications/{id}/parent_approvable_requests – 経費申請に関連付ける各種申請の更新
POST /api/1/payment_requests – 支払依頼の作成
GET /api/1/payment_requests/{id} – 支払依頼の取得
PUT /api/1/payment_requests/{id} – 支払依頼の更新
POST /api/1/payment_requests/{id}/actions – 支払依頼の承認操作
変更種別: 破壊的変更なし
変更内容:
経費申請の作成・更新APIのリクエストおよび各種レスポンスにおいて、外貨に関する以下の任意プロパティが追加されました。
(10/20)[会計]経費申請一覧の取得APIの外貨対応
変更対象API:
GET /api/1/expense_applications – 経費申請一覧の取得
変更種別: 破壊的変更なし
変更内容:
10/19 の経費申請APIの外貨対応に合わせて、経費申請一覧の取得APIのレスポンスにも use_currency、expense_application_purchase_line_currency、expense_application_line_currency_amount の各任意プロパティが追加されました。
(10/21)[販売]担当者・登録者・更新者のメンバー情報対応およびメンバー一覧APIの追加
変更対象API:
GET /master/members – メンバー一覧
GET /master/custom_fields/business/definitions – 案件カスタム項目定義一覧
GET, POST /advance_receipts – 前受金一覧・登録
GET, PATCH /advance_receipts/{id} – 前受金詳細取得・更新
POST /advance_receipts/{id}/periodic_reduction – 前受金取崩(定期売上登録)
POST /advance_receipts/{id}/reduction – 前受金取崩(売上登録)
GET, POST /businesses – 案件一覧・登録
GET, PATCH /businesses/{id} – 案件詳細取得・更新
GET, POST /cost_budgets – 原価予算一覧・登録
GET, PATCH /cost_budgets/{id} – 原価予算詳細取得・更新
GET, POST /deliveries – 納品一覧・登録
GET, PATCH /deliveries/{id} – 納品詳細取得・更新
GET /other_costs – その他原価一覧
GET /other_costs/{id} – その他原価詳細取得
GET, POST /periodic_sales – 定期売上一覧・登録
GET, PATCH /periodic_sales/{id} – 定期売上詳細取得・更新
GET /periodic_sales/{id}/sales_entries – 売上計上状況取得
GET, POST /procurements – 仕入一覧・登録
GET, PATCH /procurements/{id} – 仕入詳細取得・更新
GET, POST /purchase_orders – 発注一覧・登録
GET, PATCH /purchase_orders/{id} – 発注詳細取得・更新
GET, POST /quotations – 見積一覧・登録
GET, PATCH /quotations/{id} – 見積詳細取得・更新
GET, POST /sales – 売上一覧・登録
GET, PATCH /sales/{id} – 売上詳細取得・更新
GET, POST /sales_orders – 受注一覧・登録
GET, PATCH /sales_orders/{id} – 受注詳細取得・更新
GET /sales_schedules – 売上予定一覧
GET, PATCH /sales_schedules/{id} – 売上予定詳細取得・更新
変更種別: 破壊的変更なし
変更内容:
■ メンバー情報への対応
メンバーの一覧を取得するエンドポイント(/master/members)が新設されました。
各種帳票の登録・更新APIのリクエストに、担当者をメンバーで指定する任意プロパティ charge_member_id が追加されました。
各種帳票の一覧・詳細取得APIのレスポンスに、任意プロパティ charge_member(担当者)、registered_by_member(登録者)、last_updated_by_member(最終更新者)が追加されました。
各種一覧取得APIに、担当者で絞り込むための任意のクエリパラメータ charge_member_ids[] が追加されました。
各種レスポンスの registered_by および last_updated_by が nullable に変更されました。売上の charge_employee も nullable に変更されました。
案件のカスタム項目に、メンバー型(member)が追加されました。
■ その他の変更
売上一覧APIに、任意のクエリパラメータ business_ids[](案件ID)、sales_no(売上番号)、start_last_updated_date / end_last_updated_date(最終更新日の期間指定)が追加されました。
原価予算の登録・更新APIのリクエストにおいて、charge_employee_id の最小値が 1 から 0 に変更されました。
(10/26)[会計]口座明細の操作APIおよび自動登録ルールの一括適用APIが追加されました。
変更対象API:
POST /api/1/wallet_txns/{id}/create_deal – 口座明細からの取引登録
POST /api/1/wallet_txns/{id}/create_private_deal – 口座明細のプライベート取引としての登録
POST /api/1/wallet_txns/{id}/create_transfer – 口座明細からの口座振替登録
POST /api/1/wallet_txns/{id}/reconcile – 口座明細で未決済取引の消込
POST /api/1/wallet_txns/{id}/ignore – 口座明細の無視
POST /api/1/wallet_txns/{id}/reset – 口座明細の未消込への変更
POST /api/1/user_matchers/apply – 自動登録ルールの一括適用
変更種別: 破壊的変更なし
変更内容:
口座明細(wallet_txns)から取引・プライベート取引・口座振替を登録するエンドポイント、未決済取引と消込するエンドポイント、明細を無視または未消込に戻すエンドポイントが新設されました。
自動登録ルールを一括で適用するエンドポイントが新設されました。
(10/26)[債権管理]入金・消込・利用状況のエンドポイント追加
変更対象API:
GET /hub/receivable_management/incoming_payments – 入金一覧取得
GET /hub/receivable_management/allocations – 消込一覧取得
POST /hub/receivable_management/allocations – 消込登録
DELETE /hub/receivable_management/allocations/{id} – 消込解除
GET /hub/receivable_management/company/usages – 当月の利用状況取得
GET /hub/receivable_management/receivables – 請求一覧取得
変更種別: 破壊的変更なし
変更内容:
入金一覧の取得、消込の一覧取得・登録・解除、当月の利用状況の取得を行うエンドポイントが新設されました。
請求一覧取得APIのクエリパラメータ report_no に、最大長 255 文字の制約が明記されました。
(10/27)[会計]取引・振替伝票の作成APIへの parent_id の追加
変更対象API:
POST /api/1/deals – 取引(収入・支出)の作成
POST /api/1/manual_journals – 振替伝票の作成
変更種別: 破壊的変更なし
変更内容:
取引および振替伝票の作成APIのリクエストに、任意プロパティ parent_id が追加されました。
(10/27)[人事労務]勤怠APIの時間外労働項目・休暇項目の見直しおよびその他手当APIの項目追加
変更対象API:
GET /api/v1/employees/{employee_id}/work_records/{date} – 勤怠の取得
PUT /api/v1/employees/{employee_id}/work_records/{date} – 勤怠の更新
GET /api/v1/employees/{employee_id}/work_record_summaries/{year}/{month} – 勤怠情報月次サマリの取得
PUT /api/v1/employees/{employee_id}/work_record_summaries/{year}/{month} – 勤怠情報月次サマリの更新
GET /api/v1/allowances – その他手当一覧の取得
POST /api/v1/allowances – その他手当の作成
GET /api/v1/allowances/{id} – その他手当の取得
変更種別: 破壊的変更なし
変更内容:
■ 勤怠APIのプロパティ名の修正(スキーマ定義の修正)
勤怠および勤怠情報月次サマリのレスポンスにおいて、プロパティ名 total_latenight_overtime_except_normal_work_min が total_latenight_overtime_except_normal_work_mins に修正されました。APIの挙動に変更はありません。
■ 勤怠APIの項目追加・非推奨化
勤怠の取得・更新APIに、休暇情報をまとめて扱う holidays が追加されました
(勤怠の更新ではリクエストにも追加)。
これに伴い、paid_holidays、special_holiday、special_holiday_setting_id、half_special_holiday_mins、hourly_special_holiday_mins などの個別の休暇項目が非推奨(deprecated)になりました。
勤怠および勤怠情報月次サマリのレスポンスに、
法定内残業に関する total_overtime_within_statutory_work_mins、total_latenight_overtime_within_statutory_work_mins が追加されました。
月次サマリにtotal_deemed_paid_overtime_within_statutory_work_mins も追加されました。
法定外労働の時間を表す total_excess_statutory_work_mins、total_latenight_excess_statutory_work_mins、total_deemed_paid_excess_statutory_work_mins などが非推奨になりました。
勤怠情報月次サマリの更新APIのリクエストに、total_overtime_within_statutory_work_mins、
total_actual_overtime_within_statutory_work_mins、
total_deemed_paid_overtime_within_statutory_work_mins、
total_overtime_excess_statutory_work_mins が追加されました。
これに伴い、total_excess_statutory_work_mins、
total_actual_excess_statutory_work_mins、
total_deemed_paid_excess_statutory_work_mins、
total_overtime_work_mins が非推奨になりました。
■ その他手当APIの項目追加
その他手当の各種レスポンスに、任意プロパティ formula_element_code が追加され、formula_element が非推奨になりました。
(10/29)[IT管理]IT管理 APIにおいて、各種部分更新(PATCH)APIで company_id が必須になりました。
変更対象API:
PATCH /hub/it_management/application_accounts/{id} – アカウント部分更新
PATCH /hub/it_management/applications/{id} – アプリ部分更新
PATCH /hub/it_management/asset_attributes/{id} – 備品属性部分更新
PATCH /hub/it_management/asset_categories/{id} – 備品種別部分更新
PATCH /hub/it_management/asset_locations/{id} – 備品保管場所部分更新
PATCH /hub/it_management/asset_statuses/{id} – 備品ステータス部分更新
PATCH /hub/it_management/assets/{asset_id}/members/{id} – 備品利用者部分更新
PATCH /hub/it_management/assets/{id} – 備品部分更新
PATCH /hub/it_management/custom_application_masters/{id} – カスタムアプリマスタ部分更新
PATCH /hub/it_management/departments/{id} – 部署部分更新
PATCH /hub/it_management/employment_types/{id} – 雇用形態部分更新
PATCH /hub/it_management/guests/{id} – ゲスト部分更新
PATCH /hub/it_management/members/{id} – メンバー部分更新
PATCH /hub/it_management/positions/{id} – 役職部分更新
PATCH /hub/it_management/product_companies/{id} – 会社部分更新
PATCH /hub/it_management/system_account_owners/{id} – システムアカウント部分更新
変更種別: 破壊的変更なし(スキーマ定義の修正)
変更内容:
APIの挙動に変更はありません。
各種部分更新(PATCH)APIのリクエストにおいて、company_id が必須項目として明記され、作成・取得など他の操作と定義が揃いました。
備品属性部分更新APIにおいて、選択肢(options)を指定する場合は options.options が必須であることが明記されました。
(10/29)[工数管理]工数入力可能なプロジェクトの取得APIが追加されました。
変更対象API:
GET /workloads/available_projects – 工数入力可能なプロジェクトの取得
変更種別: 破壊的変更なし
変更内容:
工数を入力できるプロジェクトの一覧を取得するエンドポイントが新設されました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee申告 年調・法定調書で、年末調整の申告書の作成方法に「インポート/手動入力」を選択している事業所(以下、「手動入力モードの事業所」)について、freee人事労務 年末調整APIのうちデータを作成・更新・削除するAPIを受け付けないように変更します。
手動入力モードの事業所に対してこれらのAPIを実行すると、403エラーを返します。
取得API(GET)は従来どおり利用できます。また、作成方法が「freee人事労務連携」の事業所と、freee申告 年調・法定調書を利用していない事業所には影響ありません。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:freee人事労務の年末調整API のうち、データを作成・更新・削除する以下の12エンドポイント
| 対象 | メソッド | パス |
|---|---|---|
| 従業員の年末調整情報 | PUT | /api/v1/yearend_adjustments/{year}/employees/{employee_id} |
| 給与・賞与情報 | PUT | /api/v1/yearend_adjustments/{year}/payroll_and_bonus/{employee_id} |
| 家族情報 | PUT | /api/v1/yearend_adjustments/{year}/dependents/{employee_id} |
| 前職情報 | PUT / DELETE | /api/v1/yearend_adjustments/{year}/previous_jobs/{employee_id} |
| 保険料情報(作成) | POST | /api/v1/yearend_adjustments/{year}/insurances/{employee_id} |
| 保険料情報(更新・削除) | PUT / DELETE | /api/v1/yearend_adjustments/{year}/insurances/{employee_id}/{id} |
| 住宅ローン控除情報 | PUT | /api/v1/yearend_adjustments/{year}/housing_loan_deductions/{employee_id} |
| 住宅ローン情報(作成) | POST | /api/v1/yearend_adjustments/{year}/housing_loans/{employee_id} |
| 住宅ローン情報(更新・削除) | PUT / DELETE | /api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}/{id} |
※変更の対象外(従来どおり利用できます)
| 対象 | メソッド | パス |
|---|---|---|
| 年末調整対象者の一覧 | GET | /api/v1/yearend_adjustments/{year}/employees |
| 従業員の年末調整情報 | GET | /api/v1/yearend_adjustments/{year}/employees/{employee_id} |
変更種別:Breaking Change
変更内容:
変更理由: 手動入力モードでは、顧問税理士(アドバイザー)が freee申告 年調・法定調書上で年末調整の内容を入力・編集します。その間に freee人事労務側からAPIで同じ従業員の年末調整データが変更されると、アドバイザーと事業所側の操作が競合し、相互に意図しない変更が起きるおそれがあります。これを防ぐため、freee人事労務の画面と同じく、APIからの変更も受け付けないようにします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/11/9
変更リリース予定日:2026/11/30
旧バージョン廃止予定日:該当なし
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
影響を受けるのは、手動入力モードの事業所に対して、年末調整の作成・更新・削除API(POST / PUT / DELETE)を実行するアプリの開発者です。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント:上記「変更対象API」の12エンドポイント
リクエスト: リクエストボディの構造に変更はありません。手動入力モードの事業所に対して実行した場合のみ、以下のエラーを返します。
レスポンス:
■ 変更後(手動入力モードの事業所の場合)
403 Forbidden
{
"status_code": 403,
"errors": [
{
"type": "forbidden",
"messages": [
"現在、freee申告で年末調整を作成中のため、freee人事労務での編集に制限がかかっています。freee人事労務での作成に戻すには、アドバイザーに確認の後、freee申告に遷移して作成方法を「人事労務連携」に切り替えてください。また、アドバイザーがfreee申告で入力した内容により、こちらに表示されている情報が上書きされることがあります。"
]
}
]
}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ユーザーの権限情報取得 APIのレスポンスから、旧帳票の郵送権限を表す doc_postings を削除します。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
対象API:
GET /api/1/users/capabilities
変更種別:
Breaking Change
内容:
レスポンス項目の doc_postingsがキーごと返らなくなります。
– APIリファレンスから doc_postings を項目から削除します。
– その他のレスポンス項目に変更はありません。
背景・理由:旧帳票機能の提供終了に伴い、該当権限で利用できる
機能がなくなったため、未使用となった権限項目を整理いたします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/11/06
リリース予定日:2026/11/13
旧バージョン廃止予定日:なし
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
・APIレスポンス内で doc_postings を参照している場合は、
参照処理の削除をお願いいたします。
・レスポンスの項目を厳密にチェックしている場合や、
doc_postings の存在を前提にパース処理を行っている場合は、
キーが存在しない場合でもエラーが発生しないようプログラムの
修正をお願いいたします。
・doc_postings を利用していない場合は、特別な対応は不要です。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント:GET /api/1/users/capabilities リクエスト:変更なし
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee会計APIに、仕訳帳を検索条件で絞り込み、該当する仕訳を
JSON 形式で取得するエンドポイントを追加しました。
freee会計の仕訳帳画面と同じ検索条件で絞り込んだ結果を、
1 回のリクエストで直接取得できます。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
新規追加API:
仕訳帳の検索API(POST /api/1/journals/search)
変更種別:
Non-Breaking Change
変更内容:
既存の仕訳帳APIとの違い:
帳票ファイル(CSV・PDF)が必要な場合は、既存の仕訳帳の
ダウンロード要求API(GET /api/1/journals)を、データを JSON で
扱う場合は仕訳帳の検索APIをご利用ください。
変更理由:
これまで仕訳帳の内容をプログラムで扱うには、ファイルの作成を
依頼し、作成の完了を待ってからダウンロードし、ファイルを解析
する必要がありました。
仕訳帳のデータを直接 JSON で取得できるようにし、外部ツールや
AIエージェントから仕訳の確認・分析を行いやすくします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/11/06(金)
変更リリース日:2026/11/06(金)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
既存の仕訳帳API
(GET /api/1/journals、GET /api/1/journals/reports/{id}/status、
GET /api/1/journals/reports/{id}/download)の仕様は変わりません。
今後も提供を続けるため、対応は必要ありません。
仕訳帳の検索APIを利用する場合は、freee会計APIリファレンスで
リクエストとレスポンスの仕様をご確認ください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント:
https://api.freee.co.jp/api/1/journals/search
リクエスト:
検索条件はリクエストボディに JSON で指定します。
発生日の期間(start_issue_date・end_issue_date)は、取引ID(deal_ids)を指定しない場合は必須です。
各パラメータは、freee会計APIリファレンスの「仕訳帳」をご確認ください。
必要な権限:
既存の仕訳帳APIと同じく、仕訳帳の参照権限が必要です。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee工数管理APIにおいて、工数入力可能なプロジェクトの取得ができる
エンドポイントをリリースしました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:
- 工数入力可能なプロジェクトの取得
(GET /workloads/available_projects)
変更種別:[Non-Breaking Change]
変更内容:
- 工数入力可能なプロジェクトの取得
(GET /workloads/available_projects)を追加しました。
- ご利用方法の詳細はfreee工数管理APIのリファレンスページをご確認ください。
工数管理APIリファレンス-freee Developers Community
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更リリース日:2026/10/29
いつもfreee人事労務APIをご利用いただきありがとうございます。
【破壊的変更を含むお知らせです】
休暇の同日複数取得への対応・パラメータ名の適正化に伴う機能追加(Non-Breaking Change)と、それに伴う勤怠API・勤怠情報月次サマリAPI・手当APIの旧パラメータの廃止予定(Breaking Change)をお知らせいたします。
旧パラメータは2027年4月頃に削除予定です。それまでの約半年間は、引き続き利用できます。
対象APIをご利用の方は、変更内容をご確認のうえ、移行期間中に新しいパラメータへの切り替えをお願いいたします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. 【`holidays` の追加】
勤怠APIに休暇の内訳を表す `holidays` を追加しました。これにより、年次有給休暇・特別休暇・代休を同じ日に複数取得した勤怠も、APIで参照・更新できます。
2025年12月22日のお知らせ「【重要】freee人事労務 API変更のお知らせ」でご案内した、特別休暇を同日に複数取得した勤怠の取得・更新時のエラーが、本変更により解消されます。
2. 【残業関連パラメータ名の変更】
勤怠API・勤怠情報月次サマリAPIに、法定内残業・時間外労働を表す新しい名前のパラメータを追加しました。パラメータ名と実際の意味(法定内残業)を一致させるための変更です
(従来名の「excess_statutory」は「法定超過」の意味)。
3. 【`formula_element_code`の追加】
手当APIに、計算に使う勤怠項目を新しい名前で返す `formula_element_code` を追加しました。
4. 【旧パラメータの廃止(破壊的変更)】
1〜3 で置き換えとなる旧パラメータは、約半年の猶予期間(移行期間)を設けたうえで、2027年4月頃に廃止(削除)する予定です。これは破壊的変更(Breaking Change)にあたります。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
・変更対象API:
– 勤怠の取得 `GET /api/v1/employees/{emp_id}/work_records/{date}`
– 勤怠の更新 `PUT /api/v1/employees/{emp_id}/work_records/{date}`
– 勤怠情報月次サマリの取得 `GET /api/v1/employees/{emp_id}/work_record_summaries/{year}/{month}`(`work_records=true` を指定した場合の日次勤怠)
・変更種別:
Non-Breaking Change(新パラメータの追加)
Breaking Change(旧パラメータの廃止:2027年4月頃予定、猶予期間は約半年。詳細は「廃止予定のパラメータ」を参照)
・破壊的変更の影響:
旧パラメータは2027年4月頃にリクエスト・レスポンスから削除される予定です。削除後は旧パラメータを使った連携が正しく動作しなくなるおそれがあるため、猶予期間(約半年)のうちに新パラメータへ切り替えてください。
取得(レスポンス)
日次勤怠に `holidays` を追加しました。その日に取得したすべての年次有給休暇・特別休暇・代休が、1件ずつ配列で返ります。
| 要素 | 説明 |
| `holiday_category` | 休暇カテゴリ(`annual_paid_holiday`:年次有給休暇、`special_holiday`:特別休暇、`compensatory_holiday`:代休) |
| `holiday_type` | 取得単位(`full`:全休、`half`:半休、`morning_off`:午前休、`afternoon_off`:午後休、`hourly`:時間休) |
| `mins` | 取得時間(分)。半休・時間休の場合に返ります |
| `time_ranges` | 取得時間帯(`start_at` / `end_at`)。時間帯を持つ休暇の場合に返ります |
| `special_holiday_setting_id` | 特別休暇設定ID。特別休暇の場合に返ります |
| `source_date` | 代休の元になった休日出勤日。代休の場合に返ります |
レスポンス例(時間帯方式の時間休で年次有給休暇を2時間、午後休で特別休暇を同日に取得した場合)
{
"date": "2026-11-02",
"holidays": [
{
"holiday_category": "annual_paid_holiday",
"holiday_type": "hourly",
"mins": 120,
"time_ranges": [
{ "start_at": "2026-11-02T09:00:00.000+09:00", "end_at": "2026-11-02T11:00:00.000+09:00" }
]
},
{
"holiday_category": "special_holiday",
"holiday_type": "afternoon_off",
"special_holiday_setting_id": 1
}
]
}
※ 休暇がない日は空の配列 `[]` が返ります。
※ 特別休暇を同日に複数取得した勤怠は、これまでエラーになっていましたが、今回の変更以降は取得できます。
ただし、旧パラメータ(`special_holiday`、`special_holiday_setting_id` など)は、1日1件の休暇しか表せません。
複数の休暇がある場合は、`holidays` を参照してください。
更新(リクエスト)
`holidays`を指定して休暇を登録できるようになりました。年次有給休暇と特別休暇、特別休暇同士など、同じ日に複数の休暇を登録できます。
リクエスト例
{
"company_id": 1,
"holidays": [
{
"holiday_category": "annual_paid_holiday",
"holiday_type": "hourly",
"time_ranges": [
{ "start_at": "2026-11-02 09:00:00", "end_at": "2026-11-02 11:00:00" }
]
},
{
"holiday_category": "special_holiday",
"holiday_type": "afternoon_off",
"special_holiday_setting_id": 1
}
]
}
指定のルール
– 特別休暇では `special_holiday_setting_id`、代休では `source_date` が必須です。
– `full`、`morning_off`、`afternoon_off` では `mins` と `time_ranges` を指定しません。
– 年次有給休暇と有給の特別休暇の `half` では `mins` を指定します。
– 時間休(`hourly`)の指定方法は、対象日に適用される勤務賃金設定の時間休の入力方式に従います。
・時間数方式の場合:`mins`(60分単位)を指定
・時間帯方式の場合:`time_ranges` を指定
※ `mins` と `time_ranges` は同時に指定できません。
– `time_ranges` の `start_at` / `end_at` は `YYYY-MM-DD HH:MM:SS` 形式で、対象日の日付で指定します。
– 代休は1件のみ指定でき、年次有給休暇・特別休暇と同時には指定できません。
※ `holidays` と旧休暇パラメータ(`paid_holidays`、`special_holiday` など)は同時に指定できません。同時に指定した場合は 400 エラーになります。
旧形式のみ、または `holidays` のみのどちらか一方でリクエストしてください。
{
"status_code": 400,
"errors": [
{
"type": "bad_request",
"messages": ["holidays と旧休暇キーは同時に利用できません。どちらか一方の形式で指定してください。"]
}
]
}
※ 特別休暇を同日に複数取得している勤怠を旧休暇パラメータで更新した場合は、従来どおり 400 エラーになります。
`holidays` を使用して更新してください。
APIリファレンス
・勤怠の取得:
https://developer.freee.co.jp/reference/hr#/%E5%8B%A4%E6%80%A0/get_employee_work_record
・勤怠の更新:
https://developer.freee.co.jp/reference/hr#/%E5%8B%A4%E6%80%A0/update_employee_work_record
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:
– 勤怠の取得・更新 `GET / PUT /api/v1/employees/{emp_id}/work_records/{date}`
– 勤怠情報月次サマリの取得・更新 `GET / PUT /api/v1/employees/{emp_id}/work_record_summaries/{year}/{month}`
・変更種別:
Non-Breaking Change(新パラメータの追加)
Breaking Change(旧パラメータの廃止:2027年4月頃予定、猶予期間は約半年。詳細は「廃止予定のパラメータ」を参照)
・破壊的変更の影響:
旧パラメータは2027年4月頃にリクエスト・レスポンスから削除される予定です。削除後は旧パラメータを使った連携が正しく動作しなくなるおそれがあるため、猶予期間(約半年)のうちに新パラメータへ切り替えてください。
・変更理由:
従来のパラメータ名に含まれる「excess_statutory」は「法定を超える」という意味ですが、実際に入っている値は法定内残業でした。名前と意味を一致させるため、新しい名前のパラメータを追加します。値の計算方法は変わりません。
| API | 旧パラメータ(廃止予定) | 新パラメータ | 意味 |
| 勤怠(取得・更新のレスポンス) | `total_excess_statutory_work_mins` | `total_overtime_within_statutory_work_mins` | 法定内残業時間(分) |
| 〃 | `total_latenight_excess_statutory_work_mins` | `total_latenight_overtime_within_statutory_work_mins` | 深夜の法定内残業時間(分) |
| 勤怠情報月次サマリ(取得・更新) | `total_excess_statutory_work_mins` | `total_overtime_within_statutory_work_mins` | 給与計算に用いられる法定内残業時間(分) |
| 〃(取得・更新) | `total_deemed_paid_excess_statutory_work_mins` | `total_deemed_paid_overtime_within_statutory_work_mins` | みなし外の法定内残業時間(分)(裁量労働制) |
| 〃(更新のリクエストのみ) | `total_actual_excess_statutory_work_mins` | `total_actual_overtime_within_statutory_work_mins` | 実労働時間ベースの法定内残業時間(分) |
| 〃(更新のリクエストのみ) | `total_overtime_work_mins` | `total_overtime_excess_statutory_work_mins` | 時間外労働時間(分) |
※ 移行期間中、レスポンスには新旧両方のパラメータが同じ値で返ります。
※ 勤怠情報月次サマリの更新で、同じ項目の新旧パラメータを両方指定した場合は 400 エラーになります。
旧パラメータのみ、または新パラメータのみで指定してください。
エラーメッセージ例:「total_excess_statutory_work_mins と total_overtime_within_statutory_work_mins は同時に指定できません。total_overtime_within_statutory_work_mins のみを指定してください。」
【重要】日次勤怠の `total_overtime_work_mins` は、今回の変更・廃止の対象外です。名称変更の対象は、勤怠情報月次サマリの更新リクエストの `total_overtime_work_mins` のみです。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
・変更対象API:
– 手当一覧の取得 `GET /api/v1/allowances`
– 手当の取得 `GET /api/v1/allowances/{id}`
・変更種別:
Non-Breaking Change(新パラメータの追加)
Breaking Change(旧パラメータの廃止:2027年4月頃予定、猶予期間は約半年。詳細は「廃止予定のパラメータ」を参照)
・破壊的変更の影響:
旧パラメータは2027年4月頃にリクエスト・レスポンスから削除される予定です。削除後は旧パラメータを使った連携が正しく動作しなくなるおそれがあるため、猶予期間(約半年)のうちに新パラメータへ切り替えてください。
計算に使う勤怠項目を、変更内容②の新しいパラメータ名で返す `formula_element_code` を追加しました。
下表以外の値は `formula_element` と同じ値が返ります。
| `formula_element`(廃止予定)の値 | `formula_element_code` の値 |
| `total_excess_statutory_work_mins` | `total_overtime_within_statutory_work_mins` |
| `total_overtime_work_mins` | `total_overtime_excess_statutory_work_mins` |
| `attendance_tag_total_excess_statutory_work_mins` | `attendance_tag_total_overtime_within_statutory_work_mins` |
| `attendance_tag_total_overtime_work_mins` | `attendance_tag_total_overtime_excess_statutory_work_mins` |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
以下のパラメータは、2027年4月頃にリクエスト・レスポンスの両方から削除する予定です(Breaking Change)。
削除日は移行状況を踏まえて確定し、あらためてお知らせいたします。
| API | 廃止予定のパラメータ | 移行先 |
| 勤怠の取得・更新 | `paid_holiday`、`paid_holidays`、`half_paid_holiday_mins`、`hourly_paid_holiday_mins`、`half_holiday_type`、`special_holiday`、`special_holiday_setting_id`、`half_special_holiday_mins`、`hourly_special_holiday_mins`、`use_half_compensatory_holiday`(レスポンスのみ) | `holidays` |
| 勤怠の取得・更新 | `total_excess_statutory_work_mins`、`total_latenight_excess_statutory_work_mins` | 変更内容②の表を参照 |
| 勤怠情報月次サマリの取得・更新 | `total_excess_statutory_work_mins`、`total_deemed_paid_excess_statutory_work_mins`、`total_actual_excess_statutory_work_mins`、`total_overtime_work_mins`(更新のリクエスト) | 変更内容②の表を参照 |
| 手当の取得 | `formula_element` | `formula_element_code` |
※ 2024年10月30日のお知らせ「半日単位と時間単位の年次有給休暇を同日に日次勤怠として登録することができるようになります。」で非推奨としていた以下も、今回あわせて削除します。
– `paid_holiday`、`half_paid_holiday_mins`、`hourly_paid_holiday_mins`、`half_holiday_type`
【過去に `paid_holidays` へ移行された方へのご注意】
2024/10/30 のお知らせで移行先としてご案内した `paid_holidays` も、`holidays` の導入に伴い廃止されます。
`paid_holidays` をご利用中の場合も、`holidays` への切り替えが必要です。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
移行期間中は旧パラメータもこれまでどおり利用できます。
2027年4月頃の削除までに、以下の改修をお願いいたします。
1. リクエスト(入力)の改修
・新しいパラメータを使うよう、連携アプリを改修してください。
・リクエスト単位で段階的に移行できます。
・【注意】1つのリクエスト内で新旧のパラメータを混在させると 400 エラーになります。必ずリクエスト単位で、新形式または旧形式のいずれかに統一してください。
2. レスポンス(出力)の改修
・レスポンスの参照先を、旧パラメータから新パラメータ(`holidays`、法定内残業・時間外労働の新パラメータ、`formula_element_code`)へ切り替えてください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
– 新パラメータの提供開始:2026/10/26(提供済み)
– アナウンス日:2026/10/28
– 移行期間(猶予期間):2026/10/26 〜 2027年4月頃(予定・約半年)
– 旧パラメータの削除:2027年4月頃(予定)
※ 確定次第、あらためてお知らせいたします
引き続きfreee人事労務APIをご利用いただけますと幸いです。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee会計APIに、口座明細を消込するエンドポイントを7本追加しました。これまでfreee会計の「自動で経理」画面で行っていた明細の消込・取引登録・口座振替登録・無視と、自動登録ルールの一括適用を、APIから行えます。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
新規追加API:
変更種別:
Non-Breaking Change
変更内容:
– 口座明細で未決済取引の消込APIは、指定した口座明細と既存の未決済取引を紐づけて消込します。決済金額の合計が明細金額と合わない場合は、差額を新しい取引として同時に登録できます。
– 口座明細からの取引登録APIは、指定した口座明細から取引を作成し、作成した取引で明細を消込します。
– 口座明細からの口座振替登録APIは、指定した口座明細を口座振替として登録します。振替先は複数の口座を指定でき、手数料等も同時に登録できます。
– 口座明細のプライベート取引としての登録APIは、指定した口座明細をプライベート取引として登録し、明細を消込します。個人事業主では事業主貸・事業主借、法人の事業所では役員貸付金・役員借入金として登録されます。
– 口座明細の無視APIは、指定した口座明細を「無視」の状態に変更します。
– 口座明細の未消込への変更APIは、「無視」または「消込済み」の口座明細を「未消込」の状態に戻します。
– 自動登録ルールの一括適用APIは、指定した未消込の明細に、まだ適用されていない自動登録ルールを一括で適用します。適用処理は非同期で実行されます。
変更理由:これまでAPIでは口座明細の取得・作成・削除しかできず、明細の個別の消込はfreee会計の画面で行う必要がありました。明細の消込をAPIから行えるようにし、外部ツールやAIエージェントから経理業務を自動化できるようにします。
本APIを利用するアプリが、アプリストアへの公開申請または上限変更申請を行う場合、当該審査においてプラン限定アプリの適用対象となります(一部例外あり)。
なお、freee-mcpでの利用や、公開申請および上限変更申請を要しないアプリについては、審査が発生しないため本適用の対象外となります。
プラン限定アプリについては以下のヘルプページをご参照ください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/10/26
変更リリース予定日:2026/10/26
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
既存のAPIの仕様は変わらないため、対応は必要ありません。
新しいエンドポイントを利用する場合は、freee会計APIリファレンスでリクエストとレスポンスの仕様をご確認ください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント:https://api.freee.co.jp/api/1/wallet_txns/{id}/reconcile ほか、上記「変更対象API」の7本です。
リクエスト:各エンドポイントのパラメータは、freee会計APIリファレンスの「口座明細」と「自動登録ルール」をご確認ください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
お知らせ掲載について、説明が不十分であったため、掲載文の一部を以下の通り文面を変更いたしました。
変更日:2026/10/27
変更前:本APIを利用する場合、プラン限定アプリの指定対象となります(一部例外あり)。
変更後:本APIを利用するアプリが、アプリストアへの公開申請または上限変更申請を行う場合、当該審査においてプラン限定アプリの適用対象となります(一部例外あり)。
なお、freee-mcpでの利用や、公開申請および上限変更申請を要しないアプリについては、審査が発生しないため本適用の対象外となります。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
下記のfreee会計APIの仕様変更は、2026/10/19(月)に適用いたしましたが、2026/10/20(火)に取りやめ、従来の仕様に戻しました。
現在は従来の仕様で動作しており、アプリの改修などの対応は不要です。
ご迷惑をおかけし大変申し訳ございません。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:[PUT] /api/1/payment_requests/{id}: 支払依頼の更新
変更種別:[Breaking Change]
変更内容:
変更理由:
支払依頼に登録された支払先口座情報が、意図しない形で書き換わることを防ぐためです。
現在は更新のたびに、支払先の取引先のメイン口座の値で支払先口座情報を上書きしています。そのため、支払先を変更していない更新でも、取引先マスタ側でメイン口座が変更されていると口座情報が入れ替わります。
本変更では、支払先が変わらない更新では上書きを行いません。支払先を変更した場合は、これまでどおり変更後の取引先のメイン口座の値を設定します。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/09/15
変更リリース日:2026/10/19(月)13:00
変更取りやめ日:2026/10/20(火)15:10(従来の仕様に戻しました)
旧バージョン廃止予定日:なし(従来の仕様を継続します)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
必要な対応:
変更を取りやめたため、アプリの改修などの対応は不要です。本変更に合わせて改修済みの場合も、そのままご利用いただけます。
2026/10/19(月)13:00〜2026/10/20(火)15:10 の間に、支払先を変えずに更新した支払依頼は、更新前の口座情報が維持されています。取引先の最新のメイン口座を反映したい場合は、該当の支払依頼を再度更新してください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント:[PUT] /api/1/payment_requests/{id}
リクエスト:※変更ありません
レスポンス:※フィールド構成に変更はありません
リクエストで指定する支払先と、支払依頼に保存される支払先口座情報の関係は、変更後は次のとおりとなります。
| リクエスト条件 | 変更後の挙動(支払先口座情報) | 従来との違い |
|---|---|---|
| 支払先が更新前と同じ取引先 | 更新前の値をそのまま維持 | 従来は取引先のメイン口座で上書きされていました(変更点) |
| 支払先が更新前と異なる取引先 | 変更後の取引先のメイン口座で更新 | 変更なし |
| 支払先を指定しない(partner_id, partner_codeをどちらも指定しない) | リクエストで指定された口座情報(bank_*)を保存 | 変更なし |
(例)取引先Aを支払先とする支払依頼を登録したのち、取引先Aのメイン口座を口座1から口座2へ変更し、その支払依頼を更新した場合
– 変更前:支払先口座情報が口座2の値に書き換わります。
– 変更後:支払先口座情報は口座1の値のまま維持されます。
ここ数日、国内外で不正アクセスやランサムウェアによる被害が相次いでおり、システム連携先や取引先を経由した情報漏えい事案も報告されています。
本件に関連し、セキュリティベンダーやJPCERT/CCからも攻撃手法や対処についての情報が提供されております。
(参考)
各社におかれましても対応を進められていることと存じますが、弊社とのシステム連携基盤を安全に保つため、「freee API利用規約」に定めております事項について、各社の開発チームやセキュリティ担当の皆様ともご共有の上、相互確認をお願いしたく存じます。
freee APIのご利用にあたり、利用規約 第5条(API接続先の義務)に基づき、以下の点について再確認をお願いいたします。
freee API 利用規約
https://app.secure.freee.co.jp/terms-freee-api.html
相互のシステムおよびユーザーを安全に保護するため、利用規約(第5条第8項〜第13項)に則り、次のような事象を検知された場合は、両社の迅速な対応のため、弊社への情報連携をお願いいたします。
上記に該当する事象を確認された場合は、速やかに以下のフォームよりご報告をお願いいたします。
(※本メールの内容に関する一般的なご質問への返信窓口ではございませんのでご了承ください。)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2027年1月1日以降はaccess_tokenの指定をheader限定にいたします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:
工数管理API全て
変更種別:
Breaking Change
変更内容:
– 現在、リファレンスの記載に反してaccess_tokenをheader以外のqueryやbodyで指定していても認可されていましたが、2027年1月1日以降はheaderでAuthorization: Bearer {access_token}と指定する方法でのみ認可されるようになります。
– ご利用方法の詳細は、freee Developers Community の 認可 > 概要 > トークン管理 > アクセストークン をご覧ください。
変更理由:[変更を行う背景・理由]
– APIリファレンスの指定方式に仕様を統一するため。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/10/22
変更リリース予定日:2027/01/01以降
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
queryやbodyで指定されているaccess_tokenを削除していただき、headerでAuthorization: Bearer {access_token}を指定してください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
プロジェクトの登録・編集APIでプロジェクトタグをリクエストに含めることができるようになります。
これに伴い、事業所設定(設定>プロジェクトタグ)で「プロジェクトでのタグ付けを必須にする」が有効な場合、プロジェクト登録時のリクエストにプロジェクトタグが含まれていないとエラーになります。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:
プロジェクトの登録(POST /projects)
プロジェクトの編集(PATCH /projects/{id})
変更種別:
Breaking Change
変更内容:
本変更により、プロジェクトの登録・編集APIでプロジェクトタグ(project_tag_groups)の指定が可能になります。 これに伴い、事業所設定で「プロジェクトでのタグ付けを必須にする」が有効な場合、以下のバリデーションが追加されます。
変更理由:[変更を行う背景・理由]
これまでプロジェクト登録・編集APIではプロジェクトタグの指定に対応していなかったため、タグ必須設定時の判定を行っていませんでした。今回、同APIでのタグ設定機能の追加に伴い、画面操作と同様の必須チェックを適用いたします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/10/14
変更リリース予定日:2026/11/26
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 対象となるお客様
事業所設定で「プロジェクトでのタグ付けを必須にする」を有効にしている方
■ 必要なご対応
プロジェクト登録API(POST)を利用する場合
リクエストに project_tag_groups パラメータを含めてリクエストを実行するよう、システムのご修正をお願いいたします。
プロジェクト編集API(PATCH)を利用する場合
既存のタグ未設定の更新リクエストには影響ありません。ただし、project_tag_groups パラメータを含めてリクエストを送る場合は、空値をセットしないようご注意ください。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント:
プロジェクトの登録(POST /projects)
プロジェクトの編集(PATCH /projects/{id})
リクエスト:共通で以下のリクエストが追加されます。
"project_tag_groups": [
{
"tag_group_id": 1,
"tag_id": 1
}
]
(9/1)[会計]freee会計 APIにおいて、フォーム用選択項目情報APIのスキーマ定義が修正
変更対象API:
変更種別: 破壊的変更なし(スキーマ定義の修正)
変更内容:
APIの挙動に変更はありません。実際に返却されるレスポンスに合わせて、スキーマ定義を以下のとおり修正しました。
account_categories 内 account_items の shortcut、および default_tax 内 tax_rate_10、tax_rate_8、tax_rate_r8、tax_rate_5 の code と name が nullable に修正されました。
account_categories 内 account_items において、default_tax、desc、help、name、shortcut、および default_tax 内の各税率(tax_rate_10、tax_rate_10_exempt_30 など)の code と name が必須項目に修正されました。account_categories の desc も必須項目に修正されました。
あわせて、default_tax 内 tax_rate_r8 の code のフォーマットが int64 に修正されました。
account_groups において、created_at、updated_at、detail_type が必須項目に修正されました。created_at と updated_at は nullable に、フォーマットは date-time に修正されました。
account_groups に、実際に返却されていた必須プロパティ company_id が追加されました。
account_groups の detail_type に列挙値 0、1、2、3、4 が明記されました(現状は常に 0 が返却されます)。
account_groups の index に最小値 0、最大値 2147483647 が明記されました。
(9/1)[会計]freee会計 APIにおいて、メモタグAPIのスキーマ定義が修正
変更対象API:
変更種別: 破壊的変更なし(スキーマ定義の修正)
変更内容:
APIの挙動に変更はありません。実際に返却されるレスポンスに
合わせて、スキーマ定義を以下のとおり修正しました。
メモタグの各種レスポンスにおいて、shortcut1 と shortcut2 が
必須項目に修正されました。
メモタグの各種レスポンスにおいて、update_date のフォーマットが date に修正されました。
(9/4)[会計]freee会計 APIにおいて、経費精算の外貨に関するエンドポイントが公開
変更対象API:
変更種別: 破壊的変更なし
変更内容:
経費精算で利用する外貨の一覧取得、作成、取得、更新および削除を行う一連のエンドポイントが新設されました。
(9/7)[会計]freee会計 APIにおいて、取引(振替)に品目・取引先・部門・セグメントタグ・メモタグの情報が追加
変更対象API:
変更種別: 破壊的変更なし
変更内容:
取引(振替)の作成・更新APIに、振替元口座行の任意のリクエストプロパティ from_item_id、from_partner_id、from_section_id、from_tag_ids、from_segment_1_tag_id、from_segment_2_tag_id、from_segment_3_tag_id が追加されました。to_walletables 内にも、
振替先口座行の任意のリクエストプロパティ item_id、partner_id、section_id、tag_ids、segment_1_tag_id、segment_2_tag_id、segment_3_tag_id が追加されました。取引先の追加・変更・削除は、「口座振替(口座間移動)での取引先タグ付与ルール」が設定されている場合のみ可能です。
取引(振替)の各種レスポンスに、必須プロパティ from_item_id、from_item_code、from_partner_id、from_partner_code、from_section_id、from_section_code、from_tag_ids が追加されました。to_walletables 内にも、必須プロパティ item_id、item_code、partner_id、partner_code、section_id、section_code、tag_ids が追加されました。
取引(振替)の各種レスポンスに、任意のプロパティ from_segment_1_tag_id、from_segment_1_tag_code、from_segment_2_tag_id、from_segment_2_tag_code、from_segment_3_tag_id、from_segment_3_tag_code が追加されました。to_walletables 内にも、任意のプロパティ segment_1_tag_id、segment_1_tag_code、segment_2_tag_id、segment_2_tag_code、segment_3_tag_id、segment_3_tag_code が追加されました。セグメントタグが利用できないプランの場合、これらのキーはレスポンスに含まれません。
(9/9)[会計]freee会計 APIにおいて、経費申請フォームに関するエンドポイントが公開
変更対象API:
変更種別: 破壊的変更なし
変更内容:
経費申請フォームの取得および更新を行うエンドポイントが新設されました。
(9/9)[会計]freee会計 APIにおいて、部門APIのスキーマ定義が修正
変更対象API:
変更種別: 破壊的変更なし(スキーマ定義の修正)
変更内容:
APIの挙動に変更はありません。実際に返却されるレスポンスに合わせて、スキーマ定義を以下のとおり修正しました。
8/24 に追加をお知らせした 404 のエラーレスポンスのうち、
部門の更新(存在しない場合は作成)APIの 404 は実際には返却されないため、削除されました。親部門コードが存在しない場合は、
従来どおり 400 のエラーレスポンスが返却されます。
(9/29)[会計]freee会計 APIにおいて、経費科目にカスタム申請項目・金額計算設定・内容の入力設定・利用可能範囲が追加
変更対象API:
変更種別: 破壊的変更なし
変更内容:
経費科目一覧の取得APIに、任意のクエリパラメータ section_ids[](申請部門ID。指定した場合、指定部門と認証ユーザーで利用可能な経費科目のみを返却)が追加されました。
経費科目の作成・更新APIに、以下の任意のリクエストプロパティが
追加されました。
経費科目の各種レスポンスに、任意のプロパティ custom_form_parts、amount_calculation_setting、line_content_setting が追加されました。
(9/24)[請求書]freee請求書 APIにおいて、請求書APIのスキーマ定義が修正
変更対象API:
変更種別: 破壊的変更なし(スキーマ定義の修正)
変更内容:
APIの挙動に変更はありません。実際に返却されるレスポンスに
合わせて、スキーマ定義を以下のとおり修正しました。
請求書の各種レスポンスの payment_type に、列挙値 cash(現金)と bill_payable(手形)が追加されました。これらは既存データや
インポート、freee販売連携などで登録された請求書で返却される値です。請求書の作成・更新APIのリクエストでは指定できません。
(9/16)[販売]freee販売 APIにおいて、仕入APIのスキーマ定義が修正
変更対象API:
変更種別: 破壊的変更なし(スキーマ定義の修正)
変更内容:
APIの挙動に変更はありません。実際に返却されるレスポンスに
合わせて、スキーマ定義を以下のとおり修正しました。
仕入一覧・仕入詳細取得APIのレスポンスの payment_status に、
実際に返却されていた列挙値 none(対象外)が追加されました。
(9/17)[販売]freee販売 APIにおいて、見積に粗利情報が追加
変更対象API:
変更種別: 破壊的変更なし
変更内容:
見積一覧APIに、粗利で絞り込むための任意のクエリパラメータ start_gross_profit_amount_excluding_tax、end_gross_profit_amount_excluding_tax(粗利額計(税抜)の下限・上限)、start_gross_profit_rate、end_gross_profit_rate(粗利率の下限・上限)が追加されました。
見積一覧APIのレスポンスに、任意のプロパティ gross_profit_amount_excluding_tax(粗利額計(税抜))と gross_profit_rate(粗利率)が追加されました。
見積登録・見積更新APIの通常明細(line_type が basic)に、
任意のリクエストプロパティ gross_profit(明細の粗利情報。原価 cost と社内メモ memo)が追加されました。粗利情報は税方式が外税の
顧客でのみ登録されます。
見積詳細取得APIのレスポンスに、任意のプロパティ gross_profit_summary(見積全体の粗利合計)が追加されました。
あわせて、通常明細に任意のプロパティ gross_profit(原価、売価、粗利額、原価率、粗利率、上乗せ率など)が追加されました。
(9/24)[販売]freee販売 APIにおいて、売上・仕入・前受金の決済ステータス変更エンドポイントが公開
変更対象API:
変更種別: 破壊的変更なし
変更内容:
売上・仕入・前受金の決済ステータスを変更するエンドポイントが新設されました。freee会計と連携しているデータの決済ステータスはfreee会計の決済状況が反映されるため、本APIでは変更できません。
(9/18)[IT管理]IT管理 APIにおいて、部署・備品種別・備品ステータスに関するエンドポイントが追加
変更対象API:
変更種別: 破壊的変更なし
変更内容:
部署、備品種別および備品ステータスの一覧取得、作成、詳細取得、部分更新および削除を行う一連のエンドポイントが新設されました。
(9/8)[工数管理]freee工数管理 APIにおいて、受注ステータスの取得エンドポイントが追加
変更対象API:
変更種別: 破壊的変更なし
変更内容:
受注ステータスの一覧を取得するエンドポイントが新設されました。
(9/28)[工数管理]freee工数管理 APIにおいて、プロジェクトのメンバーの従業員単価マスタIDが任意項目に変更
変更対象API:
変更種別: 破壊的変更なし
変更内容:
プロジェクトの登録・編集APIのリクエストプロパティ members 内 unit_cost_id が必須項目から任意項目に変更されました。use_standard_unit_cost が false の場合は必須、true の場合は省略できます。
(9/28)[工数管理]freee工数管理 APIにおいて、工数に従業員単価の情報が追加
変更対象API:
変更種別: 破壊的変更なし
変更内容:
工数の各種レスポンスに、任意のプロパティ unit_cost_id(工数に適用された従業員単価マスタID)、unit_cost_name(従業員単価マスタ名)、unit_cost_amount(従業員単価の金額)が追加されました。工数の人件費をエクスポートする権限がある場合のみ返却されます。
(9/28)[工数管理]freee工数管理 APIにおいて、プロジェクトタググループの取得エンドポイントが追加
変更対象API:
変更種別: 破壊的変更なし
変更内容:
配下のプロジェクトタグを含むプロジェクトタググループの一覧を取得するエンドポイントが新設されました。
(9/30)[工数管理]freee工数管理 APIにおいて、プロジェクトのメンバーに単価情報が追加
変更対象API:
変更種別: 破壊的変更なし
変更内容:
プロジェクトの登録・詳細の取得・編集APIのレスポンスの members に、任意のプロパティ unit_cost_id(このプロジェクトで使用する従業員単価マスタID)、budgets_cost(予算計算用の単価)、use_standard_unit_cost(従業員の標準単価マスタを使用しているかどうか)が追加されました。人件費の閲覧権限がある場合のみ返却されます。
(9/30)[工数管理]freee工数管理 APIにおいて、勤怠情報の一括登録・更新エンドポイントが追加
変更対象API:
変更種別: 破壊的変更なし
変更内容:
外部の勤怠データを工数管理に取り込み、工数照合に必要な日単位の勤怠情報(勤務区分 day_status、勤務時間 worked_minutes)を最大31日分まとめて登録・更新するエンドポイントが新設されました。対象従業員の勤怠連携設定が「Public API」になっていない場合はエラーになります。
2026年7月23日に公開いたしました
「freee販売 API仕様変更およびメンバーID追加のお知らせ」の内容に
訂正と更新がございます。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
当該記事では、リリース日が2026年9月上旬~中旬(予定)として
おりましたが、2026年10月21日(予定)とさせていただきます。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象のパスについて、記載に誤りがございました。
現時点での正しいものを記載いたします。
マスタAPI (メンバー)
GET /master/members
変更内容:
対象のAPI:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
前回ご案内した通り、本リリース以降に新しく招待・追加されたメンバーには、
従来の「従業員ID(employee_id)」が発行されない場合があります。
これは、freee人事労務に登録しない場合でも、freee販売の利用を
可能にするためのシステム変更により発生するものです。
freee人事労務に従業員として登録されているユーザは、引き続き
従業員ID(employee_id)を利用可能です。また、それとあわせて
メンバーID(member_id)も利用できる仕様に変更いたします。
リリース日以降も当面の間、ほとんどのAPIにおいては
従業員ID (employee_id) により、登録者・変更者・社内担当者の情報を
登録・変更・取得を行うことができますが、お早めに
メンバーID (member_id) への移行をお願いいたします。
メンバーID を参照するための GET /master/members は
以下のような形式でデータを返します。
{
"members": [
{
"id": "01JQ8M3ZK7XH2B9N4V6T1RCDYA",
"num": "A001",
"display_name": "田中太郎"
},
{
"id": "01JQ8M40B2Q5R7S9T1V3W5X7Y9",
"num": "A002",
"display_name": "山田花子"
}
]
}
変更される各種APIの挙動については、以下の変更前後の比較をご参照ください。
データ登録・変更時
| 変更前リクエストボディ | 変更後リクエストボティ |
{ | {※当面の間、変更前のリクエスト方法も受け付けております。 |
データ検索 (一覧) 時
| 変更前リクエストクエリ | 変更後リクエストクエリ |
| charge_employee_ids[]=123 | charge_member_ids[]=01JQ8M3ZK7XH2B9N4V6T1RCDYA ※当面の間、変更前のリクエスト方法も受け付けております。 charge_employee_ids[] と併用した場合は、 正しい検索結果とならない場合がございます。 |
データ取得 (一覧・詳細) 時
| 変更前レスポンスボティ | 変更後レスポンスボディ |
{※ 一部フィールドを抜粋 | 当該のメンバーが、freee人事労務の従業員として登録されている場合 (現在の仕様で登録されている方) は従来のフィールドに加え、メンバーの情報も返されます。{当該のメンバーが、freee人事労務の従業員として登録されていない場合は、旧来の employee フィールドは null となります。このため、今までは nullable: false であった項目が nullable: true となります。 { |
ただし、案件のカスタム項目の 取得 (GETレスポンス) に関しては、
強制的にメンバーID(member_id)のみを返す挙動に変更させていただきます。
GET /businesses および GET /businesses/{id} における、従業員を扱うカスタム項目の
フィールドを以下の形に変更します。
| 変更前レスポンスボディ | 変更後レスポンスボディ |
メンバーを扱うフィールドについて type が employee、id は数値として返されます。{ | メンバーを扱うフィールドについて type が member、id は文字列として返されます。{ |
なお、案件の作成、更新 (POST /businesses, PATCH /businesses/{id}) のカスタム項目について、
互換性維持のため従来通り従業員ID (employee_id) による値も受け付けておりますが、
メンバーID (member_id) による値の送信をおすすめいたします。
また、GET /master/custom_fields/business/definitions については、
type employee で扱っていたフィールドは、type member に変更させていただきます。
| 変更前レスポンスボディ | 変更後レスポンスボディ |
{ | { |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
「変更の詳細」で記載したとおり、リリース日以降も当面の間、
ほとんどのAPIにおいては従業員ID (employee_id) により、
登録者・変更者・社内担当者の情報を登録・変更・取得を行うことができます。
ただし、リリース日以降に新たに追加されたメンバーについては、
従業員ID(employee_id) がないといった取り扱いが発生します。
このため、登録者・変更者・社内担当者・案件のカスタム項目での
メンバー項目をお客様で利用している場合は、お早めにメンバーID (member_id) を利用した
実装への変更をお願いいたします。
下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。
メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願いいたします。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2026年以降の年末調整において、年末調整従業員住宅ローンの作成・更新 API で、
「住宅借入金等特別控除区分」(`category`)に `extension`(増: 特定増改築等)を指定できなくなります。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:
– `POST /api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}`
(年末調整従業員住宅ローンの作成)
– `PUT /api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}/{id}`
(年末調整従業員住宅ローンの更新)
変更種別:Breaking Change
変更内容:
– year パラメータに2026年以降を指定した POST / PUT リクエストにおいて、リクエストボディの`category` に `extension` を指定した場合、400 エラーを返却します。
– year パラメータに2025年以前を指定した場合は、従来どおり `extension` を指定できます。
変更理由:
特定増改築等住宅借入金等特別控除は、2021 年(令和 3 年)12 月 31 日までに居住を開始した場合が適用対象で、控除期間は 5 年間のため、2025 年(令和 7 年)分が最終の適用年となります。2026 年(令和 8 年)分以降は制度上の適用対象者がいなくなり、国税庁の源泉徴収票の様式からも区分「増」が削除されました。これに伴い、freee人事労務においても 2026 年以降の年末調整では当該区分の入力を受け付けない仕様に変更します。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/10/9
変更リリース予定日:2026/10 中旬
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2026年以降の年末調整の住宅ローン情報を作成・更新するアプリ開発者が影響を受けます。以下の対応・確認をお願いいたします。
#### POST / PUTリクエストの改修・確認(対応必須)
category に extension を指定して住宅ローン情報を作成・更新しているロジックがある場合、yearパラメータに2026年以降を指定するリクエストでは extension を送信しないようアプリ側での改修・ご確認をお願いいたします。2026年以降は制度上 extension に該当する住宅ローンは存在しないため、general / qualified / earthquake のいずれかを指定してください。
#### GETリクエストを利用している場合(対応不要)
レスポンスの内容・構造に変更はないため、アプリ側の改修は不要です。
#### 2025年以前のデータへの影響
yearパラメータに2025年以前を指定する場合は、本仕様変更の影響を受けません。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント:
/api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}
リクエスト:POST
エンドポイント:
/api/v1/yearend_adjustments/{year}/housing_loans/{employee_id}/{id}
リクエスト:PUT
POST / PUT ともにリクエストボディの構造に変更はありません。
yearパラメータに2026年以降を指定した場合、categoryにextension を指定するとエラーになり、住宅ローン情報は作成・更新されません。general / qualified / earthquake は従来どおり指定できます。
【リクエストボディ例】
{
"company_id": 1,
"housing_loan": {
"residence_start_date": "2021-06-01",
"remaining_balance_at_yearend": 5000000,
"category": "extension", // ← 2026年以降の場合、extension を指定するとエラーになります
"specific_case_type": "not_qualified"
}
}
レスポンス:上記リクエストに対するレスポンスが以下のとおり変わります。
【変更前】(yearパラメータが2025年以前の場合)
POST は 201 Created、PUT は 200 OK で住宅ローン情報が作成・更新されます。
{
"housing_loan_deduction": 500000,
"housing_loans": [
{
"id": 1,
"residence_start_date": "2021-06-01",
"remaining_balance_at_yearend": 5000000,
"category": "extension", // ← 2025年以前の場合は従来どおり登録されます
"specific_case_type": "not_qualified"
}
]
}
【変更後】(yearパラメータが2026年以降の場合)
POST / PUT ともに 400 Bad Request を返却し、住宅ローン情報は作成・更新されません。
{
"status_code": 400,
"errors": [
{
"type": "bad_request",
"messages": ["住宅借入金等特別控除区分は2026年以降「増: 特定増改築等」を選択できません"] // ← エラーメッセージが返却されます
}
]
}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee人事労務 年末調整API 家族情報の更新において、配偶者の「給与収入」に設定できる値の最小値を0円に変更します。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:PUT /api/v1/yearend_adjustments/{year}/dependents/{employee_id}
変更種別:Breaking Change
変更内容:
変更理由:
給与収入にマイナスの値を設定することは業務上・仕様上不適切であるため
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/10/08
変更リリース予定日:2026/10/09
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
エンドポイント:/api/v1/yearend_adjustments/{year}/dependents/{employee_id}
リクエスト:PUT
[変更前]
employment_revenue(給与収入)
[変更後]
employment_revenue(給与収入)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee工数管理APIにおいて、勤怠情報の一括登録・更新ができるエンドポイントをリリースしました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:
勤怠情報の一括登録・更新(PUT /daily_attendances/bulk)
変更種別:
Non-Breaking Change
変更内容:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更リリース日:2026/09/30
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
freee工数管理APIにおいて、プロジェクトタググループの取得が
できるエンドポイントをリリースしました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:
プロジェクトタググループの取得API(GET /project_tag_groups)
変更種別:
Non-Breaking Change
変更内容:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更リリース予定日:2026/09/28
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
売上・前受金・仕入の決済ステータスの操作が可能なAPIを
新規公開しました。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
変更対象API:
変更種別:
Non-Breaking Change
会計未連携の売上・前受金・仕入データの決済ステータス変更が
可能になりました。
変更内容:
売上・前受金・仕入の決済ステータス変更が可能になりました。
変更理由:API経由での会計未連携の売上・前受金・仕入データの
決済ステータス変更を可能にし、利便性を向上させるため。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
アナウンス日:2026/09/29
リリース日:2026/9/24
旧バージョン廃止予定日:なし
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
特に必要な対応はありません。 新機能を利用される場合は、APIリファレンスをご確認ください。