# Batch jobs

Process multiple API requests asynchronously with a single file upload.

The Batch Jobs API allows you to perform bulk operations on Stripe resources. Instead of making individual API calls for each operation that could trigger rate limits, you can upload a file with all of your operations and let Stripe process them asynchronously. Use this for one-time migrations, bulk updates, or any operation that requires processing many resources.

## When to use batch jobs

Batch jobs work well for:

- **Bulk migrations**: Move large numbers of subscriptions to new billing modes.
- **Mass updates**: Update many accounts or subscriptions at once.

Batch jobs don’t work well for:

- Operations that require an immediate synchronous response.
- Real-time processing with tight timing requirements.
- A single asynchronous call.

To process a batch job, follow these steps:

1. [Create a batch job](https://docs.stripe.com/batch-api/create.md#create-a-batch-job) and specify the target API endpoint.
1. [Upload the input file](https://docs.stripe.com/batch-api/create.md#upload-the-input-file) with your batch requests.
1. [Monitor job status](https://docs.stripe.com/batch-api/create.md#monitor-job-status) through webhooks or polling.
1. [Download the results](https://docs.stripe.com/batch-api/create.md#download-the-results).

## Supported endpoints

The Batch Jobs API supports the following endpoints. Each batch job targets a single endpoint, and all requests in the batch go to that endpoint.

| Endpoint                                                                         | Path                                 |
| -------------------------------------------------------------------------------- | ------------------------------------ |
| [Update a customer](https://docs.stripe.com/api/customers/update.md)             | POST `/v1/customers/:id`             |
| [Create a promotion code](https://docs.stripe.com/api/promotion_codes/create.md) | POST `/v1/promotion_codes`           |
| [Update a promotion code](https://docs.stripe.com/api/promotion_codes/update.md) | POST `/v1/promotion_codes/:id`       |
| [Migrate a subscription](https://docs.stripe.com/api/subscriptions/migrate.md)   | POST `/v1/subscriptions/:id/migrate` |
| [Update a subscription](https://docs.stripe.com/api/subscriptions/update.md)     | POST `/v1/subscriptions/:id`         |

## Limitations

Review the following limitations:

- Batch files are limited to 5 GB. If you need to process a larger file for a higher volume of requests, split it into multiple batches.

- Batch jobs only support JSONL (newline-delimited JSON) files. Batch jobs don’t accept CSV or other formats.

- Requests in a batch can only use `POST` or `DELETE`. Batch jobs don’t support `GET`.

- All requests in a batch must target the same API endpoint.

- Batch jobs don’t guarantee the order of request processing.

- Batch jobs have a maximum processing duration of 24 hours. Jobs that exceed this limit transition to `timeout` status, with partial results available.

- Results are available for download for 7 days after the job completes.

- The upload URL expires 5 minutes after job creation. After that period, the job transitions to `upload_timeout` and you need to create a new one.

- Upload the file with a direct HTTP `PUT` request to the presigned URL.