Skip to main content
GET
/
v2
/
operations
/
{operation_id}
curl --location --request GET 'https://api.audienceful.com/v2/operations/task-abc123' \
--header 'X-Api-Key: <your-api-key>'

import requests

url = "https://api.audienceful.com/v2/operations/task-abc123"
headers = {
    "X-Api-Key": "<your-api-key>",
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.audienceful.com/v2/operations/task-abc123", {
  method: "GET",
  headers: {
    "X-Api-Key": "<your-api-key>",
  },
});
const data = await response.json();
console.log(data);

{
  "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, triggering automation events, and transactional emails — 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_id
string
required
The operation_id returned by a 202 response.

​
Response

​
id
string
The operation id.
​
status
string
The current status of the operation.
​
result
object
A summary of the operation’s outcome. Present only when status is succeeded.
curl --location --request GET 'https://api.audienceful.com/v2/operations/task-abc123' \
--header 'X-Api-Key: <your-api-key>'

import requests

url = "https://api.audienceful.com/v2/operations/task-abc123"
headers = {
    "X-Api-Key": "<your-api-key>",
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.audienceful.com/v2/operations/task-abc123", {
  method: "GET",
  headers: {
    "X-Api-Key": "<your-api-key>",
  },
});
const data = await response.json();
console.log(data);

{
  "id": "task-abc123",
  "status": "succeeded",
  "result": {
    "created": 2,
    "updated": 0,
    "skipped": 0,
    "total": 2
  }
}