# Batch Clients Bulk import clients from a CSV file. Flow — GET index (optional) → upload → process → GET/PUT mapping → validate → validation → POST create → status. DELETE to discard. No configure step. ## Get Current Batch Client Import Job - [GET /api/v3/imports/clients](https://docs.invoicexpress.com/v3/batch-clients/getv3batchclientjob.md): Returns the most recent non-expired batch client import metadata. Returns 204 if no active batch exists. ## Start Batch Client Import - [POST /api/v3/imports/clients](https://docs.invoicexpress.com/v3/batch-clients/createv3batchclients.md): Enqueues a background job to create clients from validated batch previews. Poll GET /api/v3/imports/clients/status for completion. ## Delete Active Batch Client Import Job - [DELETE /api/v3/imports/clients](https://docs.invoicexpress.com/v3/batch-clients/deletev3batchclientjob.md): Destroys the currently active batch client import and associated S3 files. ## Get Batch Client Import Status - [GET /api/v3/imports/clients/status](https://docs.invoicexpress.com/v3/batch-clients/getv3batchclientstatus.md): Returns the current status of the batch client import job. Poll after POST /api/v3/imports/clients. ## Get Batch Client CSV Template - [GET /api/v3/imports/clients/template](https://docs.invoicexpress.com/v3/batch-clients/getv3batchclienttemplate.md): Returns a presigned S3 URL to download the batch client CSV template. Required column: name. All other columns (including fiscal_id) are optional. ## Upload CSV for Batch Client Import - [POST /api/v3/imports/clients/upload](https://docs.invoicexpress.com/v3/batch-clients/uploadv3batchclientcsv.md): Validates the CSV file and uploads it to S3. Creates a new batch metadata record with import type clients. ## Process Uploaded CSV (Batch Client Mapping) - [POST /api/v3/imports/clients/process](https://docs.invoicexpress.com/v3/batch-clients/processv3batchclientcsv.md): After uploading, call this with separator and header info to build the client field mapping. ## Get CSV Column Mapping for Client Import - [GET /api/v3/imports/clients/mapping](https://docs.invoicexpress.com/v3/batch-clients/getv3batchclientmapping.md): Returns the CSV column-to-field mapping for the active batch client import. ## Save CSV Column Mapping for Client Import - [PUT /api/v3/imports/clients/mapping](https://docs.invoicexpress.com/v3/batch-clients/savev3batchclientmapping.md): Saves the user-selected column-to-field mapping for the active batch client import. ## Start Batch Client CSV Validation - [POST /api/v3/imports/clients/validate](https://docs.invoicexpress.com/v3/batch-clients/validatev3batchclients.md): Enqueues a background job to validate the CSV rows. Requires batch in "mapping" status. Poll GET /api/v3/imports/clients/validation for results. ## Get Batch Client Validation Status - [GET /api/v3/imports/clients/validation](https://docs.invoicexpress.com/v3/batch-clients/getv3batchclientvalidation.md): Poll after POST /api/v3/imports/clients/validate to get validation status and result.