---
title: Split Excel API
slug: split-excel
url: https://apyhub.com/flowdocs/service/split-excel
provider: FlowDocs
categories: [Developer Tools, File Manipulation]
tags: [excel, spreadsheet, file-splitting, workbook-processing, batch-jobs]
auth: api_key
---

# Split Excel API

Split .xlsx and .xlsm files into one workbook per value group. Track job status, progress, and download finished split outputs.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `` | What it does Splits uploaded Excel files into separate workbooks based on the values found in a spe… | 50 |
| GET | `/status/:job_id` | What it does Returns the current status of an Excel split job identified by jobid. The response inc… | 1 |
| GET | `/download/:job_id` | What it does Downloads the finished output file for a completed Excel split job. The request uses t… | 5 |
| GET | `/overall-status` | What it does Returns the aggregate progress for one or more Excel split jobs. Provide the job ID(s)… | 1 |

## About

## What it does
Excel Splitter takes one or more Excel workbooks and splits each file into separate workbooks based on the values in a chosen column. Send `.xlsx` or `.xlsm` files, plus the sheet index and target column index for each file, and you get back job records you can track while the split runs.

The main response includes a `jobs` array with `job_id`, `filename`, `status`, `progress`, and the sheet and column indices used for each file. Use the status endpoint to check an individual job by `job_id`, or the overall-status endpoint to track multiple jobs together with aggregated `status`, `progress`, `total_files`, `completed_files`, and per-job `details`.

When a job finishes, download the resulting split workbook with the download endpoint using the same `job_id`. This is useful when you need to break a sales export, customer list, or inventory sheet into one workbook per group value without doing the split manually in spreadsheet software.

Excel Splitter is a file manipulation utility for backend workflows, batch processing, and internal ops tools where spreadsheet partitioning needs to happen programmatically.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/flowdocs/service/split-excel