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

# List Callback Tasks

> Tenant or admin workflow endpoint for operator queues, callback tasks, supervisor actions, and follow-up processing.

Tenant or admin workflow endpoint for operator queues, callback tasks, supervisor actions, and follow-up processing.

### Query parameters

<ParamField query="status" type="CallbackTaskStatus" />

<ParamField query="disposition" type="CallbackDisposition" />

<ParamField query="stream_sid" type="string" />

<ParamField query="queue_key" type="string" />

<ParamField query="overdue_only" type="boolean" />

<ParamField query="limit" type="integer (int64)" />

<ParamField query="offset" type="integer (int64)" />

### Response

`object`

<ResponseField name="ok" type="boolean" required />

<ResponseField name="tenant" type="string" required>
  Tenant id the listing is scoped to
</ResponseField>

<ResponseField name="count" type="integer" required>
  Number of tasks in this response
</ResponseField>

<ResponseField name="tasks" type="CallbackTask[]" required>
  <Expandable title="CallbackTask">
    <ResponseField name="acknowledged_at" type="string" required />

    <ResponseField name="acknowledged_by" type="string,null" />

    <ResponseField name="agent_name" type="string,null" />

    <ResponseField name="assigned_to" type="string,null" />

    <ResponseField name="call_sid" type="string,null" />

    <ResponseField name="claimed_at" type="string" required />

    <ResponseField name="completed_at" type="string" required />

    <ResponseField name="created_at" type="string" required />

    <ResponseField name="created_by" type="string,null" />

    <ResponseField name="customer_phone" type="string,null" />

    <ResponseField name="dispatch_attempt_count" type="integer (int32)" required />

    <ResponseField name="disposition" type="CallbackDisposition" required />

    <ResponseField name="due_at" type="string" required />

    <ResponseField name="id" type="string" required />

    <ResponseField name="last_dispatch_attempted_at" type="string" required />

    <ResponseField name="last_dispatch_call_sid" type="string,null" />

    <ResponseField name="last_dispatch_status" type="string,null" />

    <ResponseField name="last_sla_alert_due_at" type="string" required />

    <ResponseField name="last_sla_alerted_at" type="string" required />

    <ResponseField name="metadata" type="any" required />

    <ResponseField name="notes" type="string,null" />

    <ResponseField name="priority" type="integer (int32)" required />

    <ResponseField name="queue_key" type="string,null" />

    <ResponseField name="sla_due_at" type="string" required />

    <ResponseField name="snooze_reason" type="string,null" />

    <ResponseField name="snoozed_until" type="string" required />

    <ResponseField name="status" type="CallbackTaskStatus" required />

    <ResponseField name="stream_sid" type="string,null" />

    <ResponseField name="summary" type="string,null" />

    <ResponseField name="tenant_id" type="string" required />

    <ResponseField name="updated_at" type="string" required />
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning                      |
| ----- | ---------------------------- |
| `200` | List callback workflow tasks |
| `401` | Unauthorized                 |
| `500` | Internal server error        |
| `503` | Database not configured      |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.voice.stateset.com/api/v1/callback-tasks' \
    --header "Authorization: Bearer $STATESET_VOICE_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true,
    "tenant": "acme-outdoors",
    "count": 2,
    "tasks": [
      {
        "acknowledged_at": "2024-01-15T10:40:00Z",
        "acknowledged_by": "tier2@stateset.com",
        "agent_name": "Support Agent",
        "assigned_to": "tier2@stateset.com",
        "call_sid": "CA1234567890abcdef1234567890abcdef",
        "claimed_at": "2024-01-15T10:33:15Z",
        "completed_at": "2024-01-15T10:45:00Z",
        "created_at": "2024-01-15T10:30:00Z",
        "created_by": "dashboard",
        "customer_phone": "+15555555678",
        "dispatch_attempt_count": 1,
        "disposition": "human_follow_up_required",
        "due_at": "2024-01-15T18:00:00Z",
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "last_dispatch_attempted_at": "2024-01-15T10:47:00Z",
        "last_dispatch_call_sid": "CA9876543210abcdef9876543210abcdef",
        "last_dispatch_status": "initiated",
        "last_sla_alert_due_at": "2024-01-15T10:45:00Z",
        "last_sla_alerted_at": "2024-01-15T10:46:10Z",
        "metadata": null,
        "notes": "Reach out after carrier update is confirmed.",
        "priority": 10,
        "queue_key": "escalations",
        "sla_due_at": "2024-01-15T10:45:00Z",
        "snooze_reason": "Waiting on carrier escalation before calling customer back.",
        "snoozed_until": "2024-01-15T12:00:00Z",
        "status": "open",
        "stream_sid": "MZ1234567890abcdef1234567890abcdef",
        "summary": "Customer requested a human follow-up about a delayed shipment.",
        "tenant_id": "tenant-123",
        "updated_at": "2024-01-15T10:32:22Z"
      }
    ]
  }
  ```
</ResponseExample>