> ## 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

`CallbackTask[]` — each element:

<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 />

### 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 YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "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>