> ## Documentation Index
> Fetch the complete documentation index at: https://developer.audienceful.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve an Operation

> Polls the status of an asynchronous operation.

Endpoints that return `202 Accepted` with an `operation_id` — [bulk contacts](/api-reference/people/bulk), [triggering automation events](/api-reference/automations/event), and [transactional emails](/api-reference/transactional/send) — 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

<ParamField path="operation_id" type="string" required>
  The `operation_id` returned by a `202` response.
</ParamField>

### Response

<ResponseField name="id" type="string">
  The operation id.
</ResponseField>

<ResponseField name="status" type="string">
  The current status of the operation.

  <Expandable title="values">
    <ResponseField name="pending">
      The operation is queued and hasn't started yet.
    </ResponseField>

    <ResponseField name="processing">
      The operation is running.
    </ResponseField>

    <ResponseField name="succeeded">
      The operation completed successfully.
    </ResponseField>

    <ResponseField name="failed">
      The operation failed.
    </ResponseField>

    <ResponseField name="canceled">
      The operation was canceled.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="result" type="object">
  A summary of the operation's outcome. Present only when `status` is `succeeded`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://api.audienceful.com/v2/operations/task-abc123' \
  --header 'X-Api-Key: <your-api-key>'
  ```

  ```python Python theme={null}
  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())
  ```

  ```javascript JavaScript theme={null}
  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);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "task-abc123",
    "status": "succeeded",
    "result": {
      "created": 2,
      "updated": 0,
      "skipped": 0,
      "total": 2
    }
  }
  ```
</ResponseExample>