Retrieve an Operation

Polls the status of an asynchronous operation.

GEThttps://api.audienceful.com/v2/operations/{operation_id}
curl --location --request GET 'https://api.audienceful.com/v2/operations/task-abc123' \
--header 'X-Api-Key: <your-api-key>'
{
  "id": "task-abc123",
  "status": "succeeded",
  "result": {
    "created": 2,
    "updated": 0,
    "skipped": 0,
    "total": 2
  }
}

Endpoints that return 202 Accepted with an operation_id — bulk contacts and triggering automation events — are processed asynchronously. Use this endpoint to poll their status. Any valid API key may poll its own operation ids; no specific scope is required.

Path parameters

operation_idstringrequired
The operation_id returned by a 202 response.

Response

idstring
The operation id.
statusstring
The current status of the operation.
Values
pending
The operation is queued and hasn't started yet.
processing
The operation is running.
succeeded
The operation completed successfully.
failed
The operation failed.
canceled
The operation was canceled.
resultobject
A summary of the operation's outcome. Present only when status is succeeded.
Last updated: July 11, 2026
Previous
Retrieve an Archive Entry
Next
Webhooks Overview