Skip to main content
GET
List in progress batch processes.

Authorizations

Authorization
string
header
required

API key passed as a Bearer token in the Authorization header. You can find your API Key on Your FirstPromoter Dashboard. Navigate to Settings → Integrations section → Manage API Keys

Headers

Account-ID
string
required

Account ID. You can find your Account ID on Your FirstPromoter Dashboard. Navigate to Settings → Integrations

Query Parameters

filters[status]

Filter by status (array or string)

Available options:
pending,
in_progress,
completed,
failed,
stopped

Response

Successfully retrieved batch processes

id
integer
Example:

8

status
enum<string>
Available options:
pending,
in_progress,
completed,
failed,
stopped
Example:

"stopped"

total
integer
Example:

5

selected_total
integer
Example:

5

processed_count
integer
Example:

0

failed_count
integer
Example:

0

action_label
string
Example:

"referral/delete"

created_at
string<date-time>
Example:

"2025-03-26T15:15:34.908Z"

updated_at
string<date-time>
Example:

"2025-03-26T15:15:34.908Z"

meta
object | null
progress
integer
Example:

0

processing_errors
string[]
Example: