---
title: "Get experiment totals"
method: GET
path: "/api/experiments/{experimentId}/totals"
tags: ["experiments"]
---

# Get experiment totals

`GET /api/experiments/{experimentId}/totals`

## Request

- Base URL: `https://api.iterable.com`
- URL: `https://api.iterable.com/api/experiments/{experimentId}/totals`
- Auth: API key in header `Api-Key`

Get lifetime send and conversion totals for each variant in a campaign experiment. This endpoint doesn't support journey experiments.

## Path parameters

- `experimentId` integer, required

## Response `200`

successful operation

- ExperimentTotalsResponse: Lifetime rollup totals for an experiment
  - `id` integer, required: Experiment ID
  - `status` 'draft' | 'ready' | 'running' | 'finished' | 'winner_found', required: Experiment status
  - `variants` ExperimentVariantTotals[], required: Totals for catalog variants
    - `id` integer, required: Variant sequence ID
    - `isControl` boolean, required: Whether this variant is the control
    - `isWinner` boolean, required: Whether this variant is the winner
    - `metrics` object, required: Lifetime send and conversion totals
    - `name` string, required: Variant name

## Other responses

- `400`: Invalid parameters
- `401`: Invalid API key
- `404`: Experiment not found

## Changes

- **2026-09-30** `cca837e62715`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/iterable/apis/iterable-api/changes/api/experiments/:experimentId/totals/get.md)

---

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