excel comparison on Document Processing REST APIs | GroupDocs Cloud

Compare Excel Files via REST in C#

Fri, 09 Oct 2026 14:45:06 +0000

Comparing Excel worksheets programmatically is a frequent requirement when you need to detect data changes, audit revisions, or generate reports. GroupDocs.Comparison Cloud SDK for .NET provides a powerful REST‑based library that makes it easy to compare Excel files via REST in C#. This guide walks you through uploading files, configuring comparison options, executing the comparison, and retrieving the result, with both C# code and cURL examples.

Compare Excel Files via REST in C# in 5 Steps

Upload the source XLSX file: Use the StorageApi.UploadFile method to place sample1.xlsx in cloud storage.

using (var stream1 = new FileStream(localFilePath1, FileMode.Open, FileAccess.Read))
{
    var uploadRequest1 = new UploadFileRequest(remoteFilePath1, stream1);
    storageApi.UploadFile(uploadRequest1);
}

Upload the target XLSX file: Repeat the upload for sample2.xlsx.

using (var stream2 = new FileStream(localFilePath2, FileMode.Open, FileAccess.Read))
{
    var uploadRequest2 = new UploadFileRequest(remoteFilePath2, stream2);
    storageApi.UploadFile(uploadRequest2);
}

Configure comparison options: Create a CompareOptions object, set the source and target file paths, define the output path, and adjust settings such as GenerateSummaryPage.

var compareOptions = new CompareOptions
{
    SourceFile = new FileInfo { FilePath = remoteFilePath1 },
    TargetFiles = new List
    {
        new FileInfo { FilePath = remoteFilePath2 }
    },
    OutputPath = remoteResultPath,
    Settings = new Settings
    {
        GenerateSummaryPage = true,
        ShowDeletedContent = true,
        ShowInsertedContent = true
    }
};

See the full API reference for CompareOptions and Settings at the API Reference.
4. Execute the comparison: Call CompareApi.CompareDocument with a CompareDocumentRequest.

var compareRequest = new CompareDocumentRequest(compareOptions);
var compareResult = compareApi.CompareDocument(compareRequest);

Download the result and clean up: Retrieve the generated result.xlsx, save it locally, and optionally delete the remote files.

var downloadRequest = new DownloadFileRequest(compareResult.Path);
using (var resultStream = storageApi.DownloadFile(downloadRequest))
using (var fileStream = new FileStream(localResultPath, FileMode.Create, FileAccess.Write))
{
    resultStream.CopyTo(fileStream);
}

// Clean up
storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath1));
storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath2));
storageApi.DeleteFile(new DeleteFileRequest(remoteResultPath));

Complete Code Example: Compare Excel Files via REST in C# Using GroupDocs.Comparison

This example demonstrates how to upload two XLSX files, compare them, and download the highlighted result.

using System;
using System.Collections.Generic;
using System.IO;
using GroupDocs.Comparison.Cloud.Sdk.Api;
using GroupDocs.Comparison.Cloud.Sdk.Client;
using GroupDocs.Comparison.Cloud.Sdk.Model;
using GroupDocs.Comparison.Cloud.Sdk.Model.Requests;

namespace CompareExcelFilesExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configuration – replace with your actual credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

            // APIs
            var compareApi = new CompareApi(config);
            var storageApi = new StorageApi(config);

            // Local and remote file names
            string localFilePath1 = "sample1.xlsx";
            string localFilePath2 = "sample2.xlsx";
            string remoteFilePath1 = "sample1.xlsx";
            string remoteFilePath2 = "sample2.xlsx";
            string remoteResultPath = "result.xlsx";
            string localResultPath = "result.xlsx";

            // Upload first Excel file
            using (var stream1 = new FileStream(localFilePath1, FileMode.Open, FileAccess.Read))
            {
                var uploadRequest1 = new UploadFileRequest(remoteFilePath1, stream1);
                storageApi.UploadFile(uploadRequest1);
            }

            // Upload second Excel file
            using (var stream2 = new FileStream(localFilePath2, FileMode.Open, FileAccess.Read))
            {
                var uploadRequest2 = new UploadFileRequest(remoteFilePath2, stream2);
                storageApi.UploadFile(uploadRequest2);
            }

            // Prepare comparison options
            var compareOptions = new CompareOptions
            {
                SourceFile = new FileInfo { FilePath = remoteFilePath1 },
                TargetFiles = new List
                {
                    new FileInfo { FilePath = remoteFilePath2 }
                },
                OutputPath = remoteResultPath,
                Settings = new Settings
                {
                    // Example: show changes in a new sheet
                    GenerateSummaryPage = true,
                    ShowDeletedContent = true,
                    ShowInsertedContent = true
                }
            };

            // Execute comparison
            var compareRequest = new CompareDocumentRequest(compareOptions);
            var compareResult = compareApi.CompareDocument(compareRequest);

            // Download the result file
            var downloadRequest = new DownloadFileRequest(compareResult.Path);
            using (var resultStream = storageApi.DownloadFile(downloadRequest))
            using (var fileStream = new FileStream(localResultPath, FileMode.Create, FileAccess.Write))
            {
                resultStream.CopyTo(fileStream);
            }

            // Optional: clean up remote files
            storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath1));
            storageApi.DeleteFile(new DeleteFileRequest(remoteFilePath2));
            storageApi.DeleteFile(new DeleteFileRequest(remoteResultPath));

            Console.WriteLine("Comparison completed. Result saved to " + localResultPath);
        }
    }
}

Note: This code example demonstrates the core functionality. Before using it in your project, make sure to update any file paths and configuration values to match your actual environment, verify that all required dependencies are properly installed, and test thoroughly in your development environment. If you encounter any issues, please refer to the official documentation or reach out to the support team for assistance.

Calling the Comparison REST API with cURL

Below is a cURL workflow that performs the same operation without writing C# code. Replace placeholder values with your actual credentials and file names.

Obtain an access token

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Upload the source XLSX file

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample1.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary "@sample1.xlsx"

Upload the target XLSX file

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample2.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary "@sample2.xlsx"

Run the comparison

curl -X POST "https://api.groupdocs.cloud/v2.0/comparison/compare" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "source_file": {"file_path": "sample1.xlsx"},
           "target_files": [{"file_path": "sample2.xlsx"}],
           "output_path": "result.xlsx",
           "settings": {
               "generate_summary_page": true,
               "show_deleted_content": true,
               "show_inserted_content": true
           }
         }'

Download the result

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/result.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o result.xlsx

For a complete list of endpoints and parameters, see the official API documentation.

Prerequisites and Setup

Install the .NET package via NuGet:

dotnet add package GroupDocs.Comparison-Cloud

Ensure you have a valid GroupDocs Cloud account and obtain your Client Id and Client Secret from the dashboard.
.NET 6.0 or later is required.

You can download the latest library from the download page.

Fine-Tuning Comparison Settings

The Settings object inside CompareOptions lets you control the output. Common adjustments include:

GenerateSummaryPage - adds a summary sheet with change statistics.
ShowDeletedContent - highlights cells that were removed.
ShowInsertedContent - highlights newly added cells.

These properties are already used in the code example above. For additional options such as Password protection or StyleChangeDetection, refer to the API Reference.

Conclusion

Comparing Excel files via REST in C# becomes straightforward with the GroupDocs.Comparison Cloud SDK for .NET. By following the steps, you can upload XLSX files, configure detailed comparison settings, execute the comparison, and retrieve a result workbook that clearly marks differences. Remember to secure your API credentials, respect file size limits, and use a temporary license for development. When you’re ready for production, purchase a full license from the pricing page to unlock unlimited usage.

FAQs

How do I compare Excel files via REST in C# using GroupDocs.Comparison?
Use the SDK to upload two XLSX files, set CompareOptions, call CompareDocument, and download the resulting file. The full workflow is illustrated in the code and cURL sections above.
What authentication method does the REST API require?
The API uses OAuth 2.0 with your client‑id and client‑secret to obtain an access token, which must be sent in the Authorization: Bearer header for every request.
Can I customize which changes are highlighted in the comparison result?
Yes. Adjust the Settings object (e.g., GenerateSummaryPage, ShowDeletedContent, ShowInsertedContent) to control the appearance of differences.
Is a temporary license enough for testing?
A temporary license from the temporary license page works for development and testing. For production deployments, acquire a full license.

Compare Excel Files via REST in C#

Mon, 21 Sep 2026 11:32:39 +0000

Analyzing changes between spreadsheet versions is a routine task for finance, reporting, and data‑validation workflows. GroupDocs.Comparison Cloud SDK for .NET provides a powerful API that makes it easy to compare Excel files in .NET without manual inspection. In this guide you will see how to set up the library, upload workbooks, call the REST endpoint from C#, retrieve detailed change information, and fine‑tune comparison options for precise results.

Before You Start: Prerequisites and Installation

Before you begin, ensure you have the following:

.NET 6.0 or later installed.
An IDE such as Visual Studio 2022.
A GroupDocs Cloud account with ClientId and ClientSecret.
Access to the GroupDocs Cloud storage where the Excel files will be uploaded.

Install the SDK via NuGet:

dotnet add package GroupDocs.Comparison-Cloud

Download the latest package from the release page. After installation, add your credentials in code as shown later. You are now ready to start the comparison workflow.

Step-by-Step Guide to Compare Excel Files in .NET

The following steps illustrate how to compare Excel files in .NET using the SDK.

Step 1: Load the Source and Target Documents

Create a configuration object with your credentials and instantiate the CompareApi.

var config = new Configuration
{
    ClientId = "YOUR_CLIENT_ID",
    ClientSecret = "YOUR_CLIENT_SECRET"
};

var compareApi = new CompareApi(config);

Step 2: Prepare the Excel Workbooks

Define FileInfo objects that point to the source and target XLSX files stored in GroupDocs Cloud storage.

var sourceFile = new FileInfo { FilePath = "input/source.xlsx" };
var targetFile = new FileInfo { FilePath = "input/target.xlsx" };

Step 3: Set Comparison Options and Settings

Configure the CompareOptions object, including detailed change settings.

var compareOptions = new CompareOptions
{
    SourceFile = sourceFile,
    TargetFiles = new List { targetFile },
    OutputPath = "output/diff_result.xlsx",
    Settings = new Settings
    {
        ShowDeletedContent = true,
        ShowInsertedContent = true,
        ShowStyleChanges = true,
        GenerateSummaryPage = true
    }
};

For a full list of settings, refer to the API reference.

Step 4: Execute the Comparison and Process Results

Call the Compare method and read the basic result information.

var compareResult = compareApi.Compare(compareOptions);
Console.WriteLine($"Comparison completed. Result file: {compareResult.Path}");
Console.WriteLine($"Number of changes detected: {compareResult.Changes?.Count ?? 0}");

Step 5: Retrieve Detailed Change Information

If you need a granular report, use the GetChanges request.

var changesRequest = new GetChangesRequest
{
    SourceFile = sourceFile,
    TargetFile = targetFile,
    OutputPath = "output/detailed_changes.json"
};
var detailedChanges = compareApi.GetChanges(changesRequest);
Console.WriteLine($"Detailed changes saved to: {detailedChanges.Path}");

With these steps you have fully automated the process of comparing Excel files in .NET.

Comparing Excel Files Programmatically - Complete Code Example

The following code demonstrates the complete workflow from configuration to result handling.

using System;
using System.Collections.Generic;
using GroupDocs.Comparison.Cloud.Sdk.Api;
using GroupDocs.Comparison.Cloud.Sdk.Client;
using GroupDocs.Comparison.Cloud.Sdk.Model;

namespace CompareExcelDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Set up API credentials (replace with your actual credentials)
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

            // Initialize Compare API
            var compareApi = new CompareApi(config);

            // Prepare source and target Excel files (must be uploaded to GroupDocs Cloud storage beforehand)
            var sourceFile = new FileInfo { FilePath = "input/source.xlsx" };
            var targetFile = new FileInfo { FilePath = "input/target.xlsx" };

            // Define comparison options
            var compareOptions = new CompareOptions
            {
                SourceFile = sourceFile,
                TargetFiles = new List { targetFile },
                OutputPath = "output/diff_result.xlsx",
                // Optional: specify that we want detailed changes for worksheets
                Settings = new Settings
                {
                    ShowDeletedContent = true,
                    ShowInsertedContent = true,
                    ShowStyleChanges = true,
                    GenerateSummaryPage = true
                }
            };

            try
            {
                // Call the Compare API
                var compareResult = compareApi.Compare(compareOptions);

                // Output basic result information
                Console.WriteLine($"Comparison completed. Result file: {compareResult.Path}");
                Console.WriteLine($"Number of changes detected: {compareResult.Changes?.Count ?? 0}");

                // Iterate through change details
                if (compareResult.Changes != null)
                {
                    foreach (var change in compareResult.Changes)
                    {
                        Console.WriteLine("--------------------------------------------------");
                        Console.WriteLine($"Change Type   : {change.ChangeType}");
                        Console.WriteLine($"Worksheet     : {change.Worksheet}");
                        Console.WriteLine($"Cell Address  : {change.CellAddress}");
                        Console.WriteLine($"Old Value     : {change.OldValue}");
                        Console.WriteLine($"New Value     : {change.NewValue}");
                        Console.WriteLine($"Is New Row    : {change.IsNewRow}");
                        Console.WriteLine($"Is New Column : {change.IsNewColumn}");
                    }
                }

                // Retrieve detailed changes via GetChanges (optional)
                var changesRequest = new GetChangesRequest
                {
                    SourceFile = sourceFile,
                    TargetFile = targetFile,
                    OutputPath = "output/detailed_changes.json"
                };
                var detailedChanges = compareApi.GetChanges(changesRequest);
                Console.WriteLine($"Detailed changes saved to: {detailedChanges.Path}");
            }
            catch (ApiException apiEx)
            {
                Console.WriteLine($"API error: {apiEx.ErrorCode} - {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Unexpected error: {ex.Message}");
            }
        }
    }
}

Note: This code example demonstrates the core functionality. Before using it in your project, make sure to update any file paths and configuration values to match your actual environment, verify that all required dependencies are properly installed, and test thoroughly in your development environment. If you encounter any issues, please refer to the official documentation or reach out to the support team for assistance.

Perform Excel Comparison via REST with cURL

You can achieve the same result without writing C# code by calling the REST API directly.

1. Authenticate and Get Access Token

curl -X POST "https://api.groupdocs.cloud/v1.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

2. Upload the Source Workbook

curl -X PUT "https://api.groupdocs.cloud/v1.0/storage/file?path=input/source.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "./source.xlsx"

3. Upload the Target Workbook

curl -X PUT "https://api.groupdocs.cloud/v1.0/storage/file?path=input/target.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "./target.xlsx"

4. Execute the Comparison

curl -X POST "https://api.groupdocs.cloud/v1.0/comparison/compare" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "source_file": {"file_path":"input/source.xlsx"},
           "target_files": [{"file_path":"input/target.xlsx"}],
           "output_path":"output/diff_result.xlsx",
           "settings": {
               "show_deleted_content": true,
               "show_inserted_content": true,
               "show_style_changes": true,
               "generate_summary_page": true
           }
         }'

5. Download the Resulting Diff Workbook

curl -X GET "https://api.groupdocs.cloud/v1.0/storage/file?path=output/diff_result.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o diff_result.xlsx

For a complete list of parameters, see the official API documentation.

Conclusion

Using the GroupDocs.Comparison Cloud SDK for .NET you can easily compare Excel files in .NET and obtain a detailed diff workbook that highlights every modification. The SDK’s REST‑based architecture lets you integrate spreadsheet comparison into any C# service, web API, or background job with minimal effort. Remember to acquire a proper license for production use; a temporary license is available from the license page and full licensing details are listed on the product site. Start automating your Excel diff workflows today and eliminate manual inspection errors.

FAQs

How can I compare Excel files in .NET without writing a lot of code?
The SDK abstracts the heavy lifting. You only need to configure credentials, point to the two XLSX files, and call compareApi.Compare. The library returns a diff file and a list of change objects.
What format does the diff result use?
By default the result is saved as an XLSX workbook, preserving the original layout while applying visual markers for deletions, insertions, and style changes.
Is it possible to compare protected Excel workbooks?
Yes. Provide the password in the FileInfo object’s Password property. The API will unlock the workbook before performing the comparison.
Do I need a license for development and testing?
A temporary license can be obtained from the license page. For production deployments you must purchase a full license as described on the product page.

excel comparison on Document Processing REST APIs | GroupDocs Cloud

Compare Excel Files via REST in C#

Compare Excel Files via REST in C# in 5 Steps

Complete Code Example: Compare Excel Files via REST in C# Using GroupDocs.Comparison

Calling the Comparison REST API with cURL

Prerequisites and Setup

Fine-Tuning Comparison Settings

Conclusion

FAQs

Read More

Compare Excel Files via REST in C#

Before You Start: Prerequisites and Installation

Step-by-Step Guide to Compare Excel Files in .NET

Step 1: Load the Source and Target Documents

Step 2: Prepare the Excel Workbooks

Step 3: Set Comparison Options and Settings

Step 4: Execute the Comparison and Process Results

Step 5: Retrieve Detailed Change Information

Comparing Excel Files Programmatically - Complete Code Example

Perform Excel Comparison via REST with cURL

Conclusion

FAQs

Read More