---
title: "Conversation Outcome Mapping Stats"
method: GET
path: "/campaigns/v1/stats/outcomes/{template}"
tags: ["Campaign Stats", "Stats"]
---

# Conversation Outcome Mapping Stats

`GET /campaigns/v1/stats/outcomes/{template}`

Get conversation counts bucketed by outcome category and sub category,
based on the team's configured outcome mapping for the given template.

- **template**: Outcome mapping template to bucket outcomes by.
- **start** / **end**: ISO 8601 date range filter applied to conversation start time.

Returns an empty list if the team has no outcome mapping configured yet.

## Path parameters

- `template` 'template_v1' | 'template_v2', required

## Query parameters

- `size` integer — Number of items per page
- `page` integer — Page number
- `search` string, nullable — Search keywords
- `start` string, date-time, nullable — Filter by start time (ISO 8601 format)
- `end` string, date-time, nullable — Filter by end time (ISO 8601 format)

## Response `200`

Conversation counts grouped by outcome category and sub category

- OutcomeStatsResponse
  - `message` string, required — Result description
  - `data` OutcomeCategoryStat[], required — Conversation counts grouped by outcome category and sub category
    - `category` OutcomeCategorySummary, required
      - `name` string, required — Outcome category name
      - `theme` string, required — Color theme for the category
      - `description` string, nullable — Category description
    - `count` integer, required — Total number of conversations in this category
    - `subCategories` OutcomeSubCategoryStat[], required — Sub category breakdown within this category
      - `name` string, required — Outcome sub category name
      - `theme` string, required — Color theme for the sub category
      - `description` string, nullable — Sub category description
      - `count` integer, required — Number of conversations in this sub category

## Other responses

- `400` — Bad request — invalid input or constraint violation
- `404` — Requested resource not found
- `422` — Validation Error
- `500` — Internal server error

## Changes

- **2026-08-27** `a9901c64edf4` — 1 info
  - added the new enum value `template_v2` to the `path` request parameter `template`

[Change history](https://skmtc.dev/interactly/apis/interactly-api-2/changes/campaigns/v1/stats/outcomes/:template/get.md)

---

[API](https://skmtc.dev/interactly/apis/interactly-api-2.md) · [All operations](https://skmtc.dev/interactly/apis/interactly-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactly/interactly-api-2/revisions/a9901c64edf4/schema)