HomeGuidesAPI Reference
Need Help?
API Reference
Need Help?
These docs are for v3. Click to read the latest docs for v2026-03-15.

List batches

get
https://api.omnisend.com/v3/batches

Get list of batches.

List of batches is available for 7 days.

Query parameter endpoint is required. You can list batches with endpoint for which API Key has permission.

Query Params
integer
≥ 0
Defaults to 0

Number of results to skip. Default is 0.

integer
1 to 250
Defaults to 100

Number of results to fetch. Default is 100, max 250.

string
enum
Allowed:
date

Batch creation date from. Format: YYYY-MM_DD

date

Batch creation date to. Format: YYYY-MM_DD

string
enum
required

API key needs to have permission to read this endpoint

Allowed:
Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?