---
title: "Get paginated task statistics"
method: GET
path: "/api/outbound/get-tasks-stats"
tags: ["Outbound"]
---

# Get paginated task statistics

`GET /api/outbound/get-tasks-stats`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/outbound/get-tasks-stats`
- Auth: HTTP bearer

Fetches all task IDs with detailed statistics including completion status,
KOLs found, and keyword processing progress. Supports pagination.

## Query parameters

- `page_size` integer
- `page_index` integer
- `status` 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled' | 'paused'
- `campaign_id` string, uuid
- `sort_by` 'created_at' | 'priority' | 'completion_percentage' | 'total_kols_found'
- `sort_order` 'asc' | 'desc'

## Response `200`

Task statistics retrieved successfully

- object
  - `success` boolean
  - `data` object
    - `tasks` object[]
      - `task_id` string, uuid
      - `task_name` string
      - `campaign_id` string, uuid, nullable
      - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled'
      - `priority` integer
      - `completion_percentage` number: Percentage of keywords completed (0-100)
      - `total_kols_found` integer: Total number of KOLs discovered
      - `total_kols_with_email` integer: Total number of unique KOLs with email discovered
      - `total_keywords` integer: Total number of keywords in task
      - `keywords_completed` integer: Number of keywords successfully processed
      - `keywords_processing` integer: Number of keywords currently being processed
      - `keywords_pending` integer: Number of keywords waiting to be processed
      - `keywords_failed` integer: Number of keywords that failed processing
      - `total_videos_processed` integer
      - `total_api_calls` integer
      - `created_at` string, date-time
      - `started_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `keywords_by_channel` object
        - `tiktok` integer
        - `instagram` integer
        - `youtube` integer
    - `pagination` object
      - `current_page` integer: Current page index (0-based)
      - `page_size` integer: Number of items per page
      - `total_pages` integer: Total number of pages
      - `total_items` integer: Total number of tasks
      - `has_next` boolean: Whether there is a next page
      - `has_previous` boolean: Whether there is a previous page
  - `processing_time_ms` integer

## Other responses

- `400`: Bad request - invalid parameters
- `500`: Internal server error

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)