freee Tax Return API transitions form identifier from sheet_key to sheet_code

The form identifier in four freee Tax Return API endpoints is transitioning from the newly deprecated sheet_key to sheet_code.

Required action

Use sheet_code instead of the deprecated sheet_key in the affected freee Tax Return API responses.

Changes

  • In available_sheets of GET /hub/tax_return/corporate, sheet_code became required and sheet_key became optional.
  • In tax_data of the financial statements, national tax, and local tax sheet APIs, sheet_key became optional and deprecated.
  • The unused component schema TaxReturn.Corporate.FinancialStatementSheetKey was removed on August 31, 2026.

Affected areas

GET /hub/tax_return/corporateGET /hub/tax_return/corporate/sheet/financial_statements/{tax_return_id}/{sheet_code}GET /hub/tax_return/corporate/sheet/national/{tax_return_id}/{sheet_code}GET /hub/tax_return/corporate/sheet/local/{tax_return_id}/{sheet_code}/{prefecture_government_code}/{city_government_code}available_sheetstax_datasheet_codesheet_key

Open official page

This summary is independently created by Release Radar and is not an official announcement from the vendor. Please read the official page for accurate details.