Use the Batches endpoints to generate a pre-signed upload URL and retrieve batch information.

Download OpenAPI specification

A batch represents a collection of files that you want to process. Unlike documents, which are limited in size and include the file directly in the request, batches handle larger payloads and diverse file types.

To upload a batch, you must first make a POST /v2/batches/{business-process} request, which returns a pre-signed upload URL. Then, use the generated AWS URL to make a PUT request to upload the batch files to the backend. Here is a sample request:

curl --location --request PUT 'https://pac-file-upload-destination2.s3.eu-central-1.amazonaws.com/20251010/1304/58a0ec77-7d67-4100-8882-181ad646aec1.bin?X-Amz-Expires=600&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVRUVVOSTHGH6RHEG%2F20250429%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20250429T134412Z&X-Amz-SignedHeaders=host&X-Amz-Signature=1abbafe059cf0534c717ed2f1047e7e0d0764031e0310174b87d861d23ff085f' \
--header 'Content-Type: text/plain' \
--data-binary '@/C:/Users/Username/AppData/Local/filename.dll'

The contents and structure of a batch depend on the underlying service specified in the business-process parameter. Unlike documents, which typically contain financial files such as invoices or credit notes, a batch can include any type of file collection, depending on the business process.

For detailed guidance on what a batch should contain, refer to the documentation of the specific Sovos service associated with your business-process.

These are the available Batches endpoints: