> For the complete documentation index, see [llms.txt](https://docs.elevateab.com/elevate-helpcenter/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elevateab.com/elevate-helpcenter/developer-reference/external-api/api-reference/summary.md).

# Summary

The Elevate A/B Testing External API /summary endpoint returns an experiment's headline visitors, orders, revenue, and significance status.

```http
GET /experiments/{testId}/summary
```

Returns an experiment's headline numbers: visitors, conversions, orders, revenue and the significance status. It is the cheap half of [`/results`](/elevate-helpcenter/developer-reference/external-api/api-reference/results.md) and the right choice for dashboards and alerts that only need the headline.

## Parameters

| Parameter                              | Description                                                                                                              |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `testId`                               | Path parameter, from [`/experiments`](/elevate-helpcenter/developer-reference/external-api/api-reference/experiments.md) |
| `startDate`, `endDate`, `timeZoneName` | The [date window](/elevate-helpcenter/developer-reference/external-api/dates-and-time-zones.md)                          |
| Filters                                | Any [filter](/elevate-helpcenter/developer-reference/external-api/filters.md)                                            |

## Response

| Field                    | Type             | What it holds                                                                                                                                                                            |
| ------------------------ | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `goal`, `currency`       | `string \| null` | The metric judged, and the currency of money values                                                                                                                                      |
| `period.dateRanges[]`    | `object`         | `startDate` and `endDate` of each running period covered                                                                                                                                 |
| `appliedFilters`         | `object`         | The filters as the API read them, values as arrays of strings                                                                                                                            |
| `totals.uniqueVisitors`  | `number`         | Visitors across all variations                                                                                                                                                           |
| `variations[].id`        | `integer`        | The variation                                                                                                                                                                            |
| `variations[].name`      | `string \| null` | Its name                                                                                                                                                                                 |
| `variations[].isControl` | `boolean`        | Whether it is the control                                                                                                                                                                |
| `variations[]` metrics   | `number \| null` | `uniqueVisitors`, `conversions`, `conversionRate`, `orders`, `revenue`, `revenuePerVisitor`, `averageOrderValue`, `addToCarts`, `addToCartRate`, `checkoutsStarted`, `checkoutStartRate` |
| `statistics.status`      | `string`         | The significance status, see [Statistics](/elevate-helpcenter/developer-reference/external-api/statistics.md)                                                                            |

```bash
curl https://elevateab.app/api/external/v1/experiments/TEST_ID/summary \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json
{
  "success": true,
  "data": {
    "goal": "CONVERSION_RATE",
    "currency": "USD",
    "period": {
      "dateRanges": [
        { "startDate": "2026-09-01 08:00:00", "endDate": "2026-09-18 11:58:35" }
      ]
    },
    "appliedFilters": {},
    "totals": { "uniqueVisitors": 20450 },
    "variations": [
      {
        "id": 1001,
        "name": "Control",
        "isControl": true,
        "uniqueVisitors": 10240,
        "conversions": 317,
        "conversionRate": 3.1,
        "orders": 325,
        "revenue": 20889.6,
        "revenuePerVisitor": 2.04,
        "averageOrderValue": 64.27
      },
      {
        "id": 1002,
        "name": "Variation 1",
        "isControl": false,
        "uniqueVisitors": 10210,
        "conversions": 347,
        "conversionRate": 3.4,
        "orders": 359,
        "revenue": 22564.1,
        "revenuePerVisitor": 2.21,
        "averageOrderValue": 62.85
      }
    ],
    "statistics": { "status": "Trending Positive" }
  }
}
```

## Worth knowing

* **No winner or probabilities here.** For those, and for profit, sessions, discounts and lift, use [`/results`](/elevate-helpcenter/developer-reference/external-api/api-reference/results.md).
* **The status is the one Elevate A/B Testing shows**, computed from your store's own statistical settings, so changing the significance threshold changes what this returns.
* **Experiments older than our current analytics return `422`.** Drafts are not published by the API at all, so they return `404`.