ニュース

サービスメンテナンス（5/19）のお知らせ

2026.05.12 freee

下記の通り、freeeの全サービス (電子公告サイト含まず) のメンテナンスを実施します。

・日時: 2026/05/19 (火) 1:00 – 5:00
・対象: freee 全サービス(電子公告サイト含まず)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

新規機能・改善

【重要】【freee会計】自動登録ルールAPIが新たに公開されました

2026.04.28 freee

freee会計APIにおいて、自動登録ルールの操作が可能になりました。

freee会計APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、必要に応じてアプリへの組み込みをご検討いただきますよう、よろしくお願い申し上げます。

概要
━━━━━━━━━━━━━━━━━━━━━━

freee会計APIに自動登録ルール（user_matchers）エンドポイントが新たに公開されました。

自動登録ルールの取得・作成・更新・削除をAPIから操作できるようになります。

■ 対象エンドポイント
━━━━━━━━━━━━━━━━━━━━━━

– 自動登録ルールの削除（DELETE /api/1/user_matchers/{id}）

– 自動登録ルール一覧の取得（GET /api/1/user_matchers）

– 自動登録ルールの更新（GET /api/1/user_matchers/{id}）

– 自動登録ルールの作成（POST /api/1/user_matchers）

– 自動登録ルールの更新（PUT /api/1/user_matchers/{id}）

■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━

2026/04/06（リリース済み）

■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━

新規エンドポイントの追加のため、既存のAPI利用に影響はありません。

自動登録ルールの操作をアプリに組み込む場合は、APIリファレンスをご参照ください。

新規機能・改善

【重要】freee会計のAPIの仕様変更のお知らせ

2026.04.27 freee

■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

取引（収入・支出）の作成・更新時における明細行の上限を、40行から100行へ拡大いたしました。

これまで最大40行だった取引の明細行が、最大100行まで操作可能になります。

■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API：

POST /api/1/deals 取引（収入・支出）の作成
PUT /api/1/deals 取引（収入・支出）の更新

変更種別：Non-Breaking Change

変更内容：

– 作成・更新時における明細行の上限を、40行から100行へ拡大いたしました。

変更理由：

– 業務要件上、40明細では足りないケースが増えてきたため

■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日：2026/04/27
変更リリース予定日：2026/04/23
旧バージョン廃止予定日：該当しない

■ 変更後のAPI仕様
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

エンドポイント：/api/1/deals（変更なし）

リリースノート

2026年3月の更新情報

2026.04.13 freee

（3/17）[販売] freee販売APIにおいて、案件情報のレスポンスにプロパティが追加されました。

変更対象API：案件一覧・詳細 – GET /businesses, GET /businesses/{id}
変更種別：破壊的変更なし
変更内容：

GET /businesses のレスポンスに任意プロパティ businesses/items/closed（ロック状態）が追加されました
GET /businesses/{id} のレスポンスに closed（ロック状態、BusinessDigest スキーマ内）が追加されました

（3/18）[販売] freee販売APIにおいて、カスタムフィールド定義に新しい対象タイプが追加されました。
変更対象API：カスタムフィールド定義 – GET /master/custom_fields/business/definitions
変更種別：破壊的変更なし
変更内容：

レスポンスの custom_field_definitions/items/type に以下の新しいenum値が追加されました：

partner（取引先）
employee（従業員）
section（部門）
master_item（商品）

新しいスキーマ定義として以下が追加されました：

PartnerCustomFieldDefinition
EmployeeCustomFieldDefinition
SectionCustomFieldDefinition
MasterItemCustomFieldDefinition

上記スキーマに対応するdiscriminatorマッピングキー（employee, section, partner, master_item）が追加されました

（3/18）[販売] freee販売APIにおいて、案件詳細のカスタムフィールド値にマスタ型が追加されました。

変更対象API：案件詳細 – GET /businesses/{id}
変更種別：破壊的変更なし
変更内容：

レスポンスの custom_fields/items/value の anyOf リストに CustomFieldMasterValue（マスタ型カスタム項目の値）が追加されました

（3/26）[人事労務] 人事労務APIにおいて、子ども・子育て支援金に関するプロパティが追加されました。
変更対象API：従業員・健康保険ルール

GET /api/v1/employees
POST /api/v1/employees
GET /api/v1/employees/{id}
PUT /api/v1/employees/{id}
GET /api/v1/employees/{employee_id}/health_insurance_rule
PUT /api/v1/employees/{employee_id}/health_insurance_rule

変更種別：破壊的変更なし
変更内容：
以下のプロパティが追加されました：

child_support_fund_bonus_calc_type（賞与の子ども・子育て支援金計算区分）
child_support_fund_salary_calc_type（給与の子ども・子育て支援金計算区分）
manual_child_support_fund_amount_of_company_bonus（会社負担の賞与子ども・子育て支援金額）
manual_child_support_fund_amount_of_company_salary（会社負担の給与子ども・子育て支援金額）
manual_child_support_fund_amount_of_employee_bonus（従業員負担の賞与子ども・子育て支援金額）
manual_child_support_fund_amount_of_employee_salary（従業員負担の給与子ども・子育て支援金額）

追加された対象は以下の通りです：

レスポンスのみ：GET /api/v1/employees、POST /api/v1/employees、GET /api/v1/employees/{id}、PUT /api/v1/employees/{id}、GET /api/v1/employees/{employee_id}/health_insurance_rule
リクエストおよびレスポンス：PUT /api/v1/employees/{employee_id}/health_insurance_rule

ニュース

サービスメンテナンス（4/23）のお知らせ

2026.04.10 freee

下記の通り、freeeの全サービス (電子公告サイト含む) のメンテナンスを実施します。

・日時: 2026/04/23 (木) 1:00 – 5:00
・対象: freee 全サービス(電子公告サイト含む)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

ニュース

【重要】アプリの権限（Scope）更新時の挙動変更

2026.04.08 freee

■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

freeeアプリストアにおいて、アプリの権限（Scope）更新時における既存アクセストークンの挙動を変更します。

freee APIをご利用の開発者の皆様におかれましては、変更点をご確認いただき、アプリの改修などの必要な対応をいただきますよう、よろしくお願い申し上げます。

■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更種別：[Breaking Change]
変更内容：

アプリのScope（権限）追加を含む変更申請がfreeeによって承認された際の、既存アクセストークンの扱いを以下のとおり変更します。

【現在】
変更申請の承認時に、そのアプリに紐づく全利用者のアクセストークンが即座に無効化されます。利用者は再認可を行うまでアプリから全てのAPIを利用できません。

ステータスコード：401

エラーメッセージ：「アプリのバージョンが更新されてデータアクセス範囲が追加されています。再度認可をしてください。」

【変更後】
変更申請の承認後も、既存のアクセストークンは有効なまま維持されます。利用者が新しいScopeを必要とする機能を利用するタイミングで、初めて再認可が必要となります。

ステータスコード：403

エラーメッセージ：「このアプリケーションにはアクセス権限がないエンドポイントです」

変更理由：

現在の仕様では、Scope更新の承認直後に全トークンが無効化されるため、バッチ処理を行うアプリにおいて処理が突然失敗するなど、利用者の業務に影響を与えるケースが発生しておりました。本変更により、既存機能の利用を中断することなく、利用者が任意のタイミングで新しい権限を認可できるようになります。

■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日：2026/04/08
変更リリース予定日：2026/04/08

■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更後は、利用者が新しいScopeを必要とするAPIエンドポイントを呼び出した際に、403エラーが返却されます。このエラーを検知した場合に、利用者を認可画面へ適切にリダイレクトする実装をお願いいたします。

新規機能・改善

【重要】販売案件登録・変更APIにおける案件コードの必須項目変更のお知らせ

2026.03.31 freee

■ 概要
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

案件登録と案件更新の任意項目「code : 案件コード」が必須項目になります。

■ 変更内容
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

変更対象API：freee販売APIの案件登録と案件更新
変更種別：Breaking Change
変更内容：

– 案件登録の任意項目「code : 案件コード」が必須項目になります。
– 案件更新の任意項目「code : 案件コード」が必須項目になります。

変更理由：freee販売の案件登録・編集時の案件コードの入力が必須になるため

■ 変更スケジュール
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日：2026/03/31
変更リリース予定日：2026/04/30

■ 対応方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

今後は案件コードを指定していただく必要があります。
案件コードの自動採番設定がONの場合は、コードを指定しなければ自動採番されたコードが活用されます。

ただし更新APIについては既に販売案件に案件コードが入っている場合は指定していなくても問題ないです。

ニュース

サービスメンテナンス（3/18）のお知らせ

2026.03.09 freee

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2026/3/18 (水) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

リリースノート

2026年2月の更新情報

2026.03.06 freee

（2/16）[販売]販売APIに納品と売上の管理APIが追加されました。

変更対象API：販売 API
変更種別：破壊的変更なし
変更内容：

GET /deliveries（納品の一覧取得）
POST /deliveries（納品の登録）
GET /deliveries/{id}（納品の詳細取得）
PATCH /deliveries/{id}（納品の更新）
GET /sales（売上の一覧取得）
POST /sales（売上の登録）
GET /sales/{id}（売上の詳細取得）
PATCH /sales/{id}（売上の更新）

リリースノート

2026年1月の更新情報

2026.02.09 freee

（1/13）[販売]販売APIで案件、受注の部分更新が可能になりました。
変更対象API：販売 API
変更種別：破壊的変更なし
変更内容：
以下の2つの新しいAPIエンドポイントが追加されました：

PATCH /businesses/{id}（案件の部分更新）
- 案件の部分的な更新が可能になります
PATCH /sales_orders/{id}（受注の部分更新）
- 受注の部分的な更新が可能になります

（1/21）[会計]会計APIで経費科目テンプレートの参照元情報を取得可能になりました。
変更対象API：会計 API
変更種別：破壊的変更なし
変更内容：経費科目テンプレート APIのレスポンスに、新しい必須プロパティ source_line_template_id が追加されます。この変更により、経費科目テンプレートの参照元情報を取得できるようになります。

以下の4つのAPIエンドポイントのレスポンスに、新しい必須プロパティ source_line_template_id が追加されました：

GET /api/1/expense_application_line_templates（経費科目テンプレート一覧の取得）
- レスポンスの expense_application_line_templates/items 内に source_line_template_id プロパティを追加
POST /api/1/expense_application_line_templates（経費科目テンプレートの作成）
- レスポンスの expense_application_line_template 内に source_line_template_id プロパティを追加
GET /api/1/expense_application_line_templates/{id}（経費科目テンプレートの取得）
- レスポンスの expense_application_line_template 内に source_line_template_id プロパティを追加
PUT /api/1/expense_application_line_templates/{id}（経費科目テンプレートの更新）
- レスポンスの expense_application_line_template 内に source_line_template_id プロパティを追加

ニュース

サービスメンテナンス（2/4）のお知らせ

2026.01.29 freee

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2026/2/4 (水) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

リリースノート

2025年12月の更新情報

2026.01.23 freee

（12/01）[人事労務] 従業員のグループ所属情報の取得APIの追加および年末調整APIにおけるバリデーションの変更が行われました。

変更対象API：従業員のグループ所属情報の取得 – /api/v1/employees/{employee_id}/group_memberships
変更種別：新規追加
変更内容：従業員が所属するグループ（部門等）の情報を取得するエンドポイントが新規追加されました。

変更対象API：年末調整（扶養家族・本人情報） – /api/v1/yearend_adjustments/...
変更種別：破壊的変更なし
変更内容：

以下のプロパティにおいて、最小値（min）が 0.00 から -999999999.00 に引き下げられ、マイナスの値を許容するようになりました。
- 扶養家族情報：all_other_income（その他の所得合計額）, employment_revenue（給与収入）
- 本人情報：all_other_income（合計所得金額見積額）, other_company_revenue（他社給与収入）

（12/10, 12/15, 12/22）[販売] freee販売 APIにおいて、ステータス定義の刷新を含む大幅な仕様変更が行われました。

変更対象API：取引先・受注 – /businesses, /sales_orders
変更種別：破壊的変更あり
変更内容：代わりに billed, delivered, not_billed, partially_billed など、より詳細な状態を示す値が追加されました。

ステータスEnumの大幅変更（12/15）各種ステータス（請求、納品、回収、売上）において、従来の todo / doing / done が削除されました。
リクエストパラメータの任意項目化・Null許容変更（12/10, 12/22）
- 取引先作成時の name や、受注作成時の customer_id, sales_order_date, lines 等の多くの項目が必須から任意（Optional）に変更されました。
- 取引先作成時、business_date と code がNull許容となった一方、prospect_sales_order はNull不可となりました。
レスポンス構造の変更（12/10, 12/15）
- POST時のレスポンスに id, last_updated_at, registered_at が必須項目として含まれるようになりました。
- 受注詳細取得において、明細行（lines）の id が必須ではなくなりました。
新規プロパティの追加（12/22）
- 受注情報に canceled（キャンセルフラグ）プロパティが追加されました。
- 取引先情報に last_updated_by（最終更新者）などの監査用プロパティが追加されました。

（12/16）[会計] 事業所詳細取得APIにおいて、会計年度のIDが含まれるようになりました。
変更対象API：事業所の詳細取得 – /api/1/companies/{id}
変更種別：破壊的変更なし
変更内容：

レスポンスの fiscal_years（会計年度）オブジェクトに、年度を特定するための id プロパティが追加されました。

（12/23）[人事労務] 勤怠管理APIにおいて、所定休日労働時間に関するプロパティが追加されました。

変更対象API：勤怠情報 – /api/v1/employees/{employee_id}/work_records, /work_record_summaries
変更種別：破壊的変更なし
変更内容：

日次の勤怠および月次の勤怠要約情報において、total_prescribed_holiday_work_mins（所定休日労働時間）がリクエストおよびレスポンスに追加されました。これにより、API経由で所定休日の労働時間の取得・更新が可能になります。

ニュース

サービスメンテナンス（1/22）のお知らせ

2026.01.15 freee

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2026/1/22 (木) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

新規機能・改善

【重要】freee人事労務 API変更のお知らせ

2025.12.22 freee

■ 概要

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

2026年1月末頃より、freee人事労務のweb版で休暇の同日取得機能が拡張され、特別休暇を含む以下の組み合わせが新たに登録可能になります。

年次有給休暇 × 特別休暇
特別休暇 × 特別休暇

現時点でpublic APIはこの機能に未対応のため、同日取得されたデータを含むリクエストはエラーとなります。

エラー例

{
    "status_code": 400,
    "errors": [
        {
            "type": "bad_request",
            "messages": [
                "特別休暇が2つ登録されています。Webで確認してください。"
            ]
        }
    ]
}

API対応時期は未定です。

①勤怠の取得では、「特別休暇と特別休暇」の組み合わせの場合で同日取得されたデータはエラーとなります。

人事労務APIリファレンス

②勤怠の更新では、「年次有給休暇と特別休暇」及び「特別休暇と特別休暇」の組み合わせで同日取得されたデータはエラーとなります。

人事労務APIリファレンス

③勤怠情報サマリのgetでwork_recordsオプションをtrueで指定した場合、「特別休暇と特別休暇」の組み合わせで同日取得されたデータが１日でも存在するとエラーとなります。

人事労務APIリファレンス

API対応時期は決まり次第改めてお知らせいたします。

■ 変更スケジュール

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

アナウンス日：2025/12/22

変更リリース予定日：2026年1月末予定

リリースノート

2025年11月の更新情報

2025.12.11 freee

（11/12）[販売]freee販売のAPIスキーマが新規に公開されました。スキーマファイルのtitleには「freee販売 API (β版)」と記載されています。

変更対象API：freee販売 API – https://api.freee.co.jp/sm
変更種別：新規追加
変更内容：

freee販売のAPIスキーマが新規に公開されました
OAuth2.0による認証
JSON形式でのリクエスト・レスポンス

（11/25）[請求書・見積書・納品書]請求書・見積書・納品書APIにおいて、データ型の変更および最大値の変更が行われました。

変更対象API：請求書 – /invoices
変更種別：破壊的変更なし
変更内容：

payment_type の enum 値に「card」(カード払い)が追加されました
tax_rate プロパティの型が整数型(integer)から数値型(number)に変更されました
複数のプロパティの最大値が「9223372036854774784.00」に変更されました
created_at プロパティの型/フォーマットが「string/date-time」から「string」に変更されました

変更対象API：見積書 – /quotations
変更種別：破壊的変更なし
変更内容：

tax_rate プロパティの型が整数型(integer)から数値型(number)に変更されました
複数のプロパティの最大値が「9223372036854774784.00」に変更されました
created_at プロパティの型/フォーマットが「string/date-time」から「string」に変更されました

変更対象API：納品書 – /delivery_slips
変更種別：破壊的変更なし
変更内容：

tax_rate プロパティの型が整数型(integer)から数値型(number)に変更されました
複数のプロパティの最大値が「9223372036854774784.00」に変更されました
created_at プロパティの型/フォーマットが「string/date-time」から「string」に変更されました

以上です。
よろしくお願いいたします。

ニュース

サービスメンテナンス（12/16）のお知らせ

2025.12.09 freee

下記の通り、freeeの全サービス (電子公告サービス除く) のメンテナンスを実施します。

・日時: 2025/12/16 (火) 1:00 – 5:00
・対象:freeeの全サービス (電子公告サービス除く)

メンテナンス中は該当サービスをご利用いただけません。
ご迷惑をおかけしますが、ご理解の程よろしくお願い致します。

リリースノート

2025年10月の更新情報

2025.11.21 freee

（10/23）[人事労務]freee人事労務APIにおいて、有給申請APIのタグ名が変更され、年末調整APIに団体生命保険に関するプロパティが追加されました。
変更対象API：有給休暇申請API – /api/v1/approval_requests/paid_holidays
変更種別：破壊的変更なし

（10/23）[人事労務]APIタグ名が「有給申請」から「有給休暇申請」に変更されました。
変更対象API：年末調整API – /api/v1/yearend_adjustments/{year}/employees/{employee_id}
変更種別：破壊的変更なし

（10/23）[人事労務]レスポンスに団体生命保険かどうかを示す is_group_insurance プロパティが追加されました。
変更対象API：年末調整保険情報登録API – /api/v1/yearend_adjustments/{year}/insurances/{employee_id}
変更種別：破壊的変更なし

（10/23）[人事労務]リクエストならびにレスポンスに団体生命保険かどうかを示す is_group_insurance プロパティが追加されました。
変更対象API：年末調整保険情報更新API – /api/v1/yearend_adjustments/{year}/insurances/{employee_id}/{id}
変更種別：破壊的変更なし

以上です。
よろしくお願いいたします。

新規機能・改善