Get background processes | Brevo API Documentation

Retrieves a list of background processes from your Brevo account with filtering and pagination.

Use this to:

Monitor background process activity and status
Track long-running operations and tasks
Find process IDs for detailed status checking
Review process history and performance
Identify failed or stuck processes for troubleshooting

Key information returned:

Process details (ID, name, type, status)
Process creation and completion timestamps
Process progress and completion status
Error information for failed processes
Process result data and download links

Important considerations:

Background processes handle long-running operations like imports and exports
Process status indicates current state (queued, processing, completed, failed, cancelled)
Export processes provide download URLs when completed
Failed processes include error messages for troubleshooting
Use pagination for accounts with many historical processes
Sort options available for creation order (ascending or descending)
Different process types handle specific operations (imports, exports, calculations)

Retrieves a list of background processes from your Brevo account with filtering and pagination. **Use this to:** - Monitor background process activity and status - Track long-running operations and tasks - Find process IDs for detailed status checking - Review process history and performance - Identify failed or stuck processes for troubleshooting **Key information returned:** - Process details (ID, name, type, status) - Process creation and completion timestamps - Process progress and completion status - Error information for failed processes - Process result data and download links **Important considerations:** - Background processes handle long-running operations like imports and exports - Process status indicates current state (queued, processing, completed, failed, cancelled) - Export processes provide download URLs when completed - Failed processes include error messages for troubleshooting - Use pagination for accounts with many historical processes - Sort options available for creation order (ascending or descending) - Different process types handle specific operations (imports, exports, calculations)

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Query parameters

limitlongOptionalDefaults to 10

Number limitation for the result returned

offsetlongOptionalDefaults to 0

Beginning point in the list to retrieve from.

sortenumOptionalDefaults to desc

Sort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

Allowed values:

Response

Background processes retrieved successfully

countlong

Total number of processes available on your account

processeslist of objects

List of background processes on your account

Errors

Retrieves a list of background processes from your Brevo account with filtering and pagination.

Use this to:

Monitor background process activity and status
Track long-running operations and tasks
Find process IDs for detailed status checking
Review process history and performance
Identify failed or stuck processes for troubleshooting

Key information returned:

Process details (ID, name, type, status)
Process creation and completion timestamps
Process progress and completion status
Error information for failed processes
Process result data and download links

Important considerations:

Background processes handle long-running operations like imports and exports
Process status indicates current state (queued, processing, completed, failed, cancelled)
Export processes provide download URLs when completed
Failed processes include error messages for troubleshooting
Use pagination for accounts with many historical processes
Sort options available for creation order (ascending or descending)
Different process types handle specific operations (imports, exports, calculations)

1	var client = new RestClient("https://api.brevo.com/v3/processes");
2	var request = new RestRequest(Method.GET);
3	request.AddHeader("api-key", "<apiKey>");
4	IRestResponse response = client.Execute(request);

1	{
2	"count": 198,
3	"processes": [
4	{
5	"id": 217,
6	"name": "IMPORTUSER",
7	"status": "completed",
8	"info": {
9	"import": {
10	"invalid_emails": 1,
11	"duplicate_contact_id": 1,
12	"duplicate_ext_id": 1,
13	"duplicate_email_id": 1,
14	"duplicate_phone_id": 1,
15	"duplicate_whatsapp_id": 1,
16	"duplicate_landline_number_id": 1
17	}
18	}
19	},
20	{
21	"id": 213,
22	"name": "SEARCH_EXPORT_USERS",
23	"status": "completed",
24	"export_url": "https://s3.eu-west-1.amazonaws.com/api-export.example.com/upload/contacts_export.csv"
25	},
26	{
27	"id": 212,
28	"name": "IMPORTUSER",
29	"status": "queued"
30	}
31	]
32	}