{
  "paths": {
    "/hub/tax_return/corporate": {
      "get": {
        "summary": "申告一覧取得",
        "description": "事業所に紐づく法人税の申告一覧をカーソルページネーションで取得します。\n各申告データの id と、利用可能な帳票一覧（available_sheets）の sheet_code が、\n帳票取得APIのパスパラメータ tax_return_id と sheet_code にそれぞれ対応します。",
        "parameters": [
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID",
            "explode": false
          },
          {
            "name": "page_size",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "1ページあたりの取得件数（10〜50、デフォルト10）",
            "explode": false
          },
          {
            "name": "page_token",
            "in": "query",
            "type": "string",
            "required": false,
            "description": "次のページを取得するためのカーソルトークン",
            "explode": false
          }
        ]
      }
    },
    "/hub/tax_return/corporate/office_info/{tax_return_id}": {
      "get": {
        "summary": "事業所情報一覧取得",
        "description": "申告に紐づく事業所情報の一覧をカーソルページネーションで取得します。\n地方税帳票取得APIで必要となる自治体コード（prefecture_government_code、city_government_code）は、このAPIから取得できます。",
        "parameters": [
          {
            "name": "tax_return_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "申告書ID"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID",
            "explode": false
          },
          {
            "name": "page_size",
            "in": "query",
            "type": "integer",
            "required": false,
            "description": "1ページあたりの取得件数（10〜50、デフォルト10）",
            "explode": false
          },
          {
            "name": "page_token",
            "in": "query",
            "type": "string",
            "required": false,
            "description": "次のページを取得するためのカーソルトークン",
            "explode": false
          }
        ]
      }
    },
    "/hub/tax_return/corporate/sheet/national/{tax_return_id}/{sheet_code}": {
      "get": {
        "summary": "国税帳票取得",
        "description": "指定した申告データの国税帳票を XML 形式 (application/xml) で取得します。\nレスポンスの XML は e-Tax の申告データ (XTX) 形式に準拠します。\nXML の各項目の仕様は [tax_return API v3 帳票項目マッピング](https://github.com/freee/freee-mcp/blob/main/skills/freee-api-skill/tax-return-references/index.md)で公開されている仕様書を参照してください。",
        "parameters": [
          {
            "name": "tax_return_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "申告ID"
          },
          {
            "name": "sheet_code",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "帳票コード（申告一覧の available_sheets[].sheet_code）"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID",
            "explode": false
          }
        ],
        "accept": "application/xml"
      }
    },
    "/hub/tax_return/corporate/sheet/local/{tax_return_id}/{sheet_code}/{prefecture_government_code}/{city_government_code}": {
      "get": {
        "summary": "地方税帳票取得",
        "description": "指定した申告データの地方税帳票を XML 形式 (application/xml) で取得します。\nレスポンスの XML は eLTAX の申告データ形式に準拠します。\nXML の各項目の仕様は [tax_return API v3 帳票項目マッピング](https://github.com/freee/freee-mcp/blob/main/skills/freee-api-skill/tax-return-references/index.md)で案内されている公開仕様書を参照してください。\n帳票のreport_unit（prefecture/city）に応じて、prefecture_government_codeまたはcity_government_codeが使用されます。",
        "parameters": [
          {
            "name": "tax_return_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "申告ID"
          },
          {
            "name": "sheet_code",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "帳票コード（申告一覧の available_sheets[].sheet_code）"
          },
          {
            "name": "prefecture_government_code",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "都道府県の自治体コード"
          },
          {
            "name": "city_government_code",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "市区町村の自治体コード"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID",
            "explode": false
          }
        ],
        "accept": "application/xml"
      }
    },
    "/hub/tax_return/corporate/sheet/financial_statements/{tax_return_id}/{sheet_code}": {
      "get": {
        "summary": "決算書取得",
        "description": "指定した申告データの決算書を XML 形式 (application/xml) で取得します。\nレスポンスの XML は e-Tax に提出する決算書 (XBRL) 形式に準拠します。\nXML の各項目の仕様は [tax_return API v3 帳票項目マッピング](https://github.com/freee/freee-mcp/blob/main/skills/freee-api-skill/tax-return-references/index.md)で公開されている仕様書を参照してください。",
        "parameters": [
          {
            "name": "tax_return_id",
            "in": "path",
            "type": "integer",
            "required": true,
            "description": "申告ID"
          },
          {
            "name": "sheet_code",
            "in": "path",
            "type": "string",
            "required": true,
            "description": "決算書の種別キー（申告一覧の available_sheets[].sheet_code）"
          },
          {
            "name": "company_id",
            "in": "query",
            "type": "integer",
            "required": true,
            "description": "事業所ID",
            "explode": false
          }
        ],
        "accept": "application/xml"
      }
    }
  }
}