---
title: "List A/B tests"
method: GET
path: "/api/v1/ab-tests"
tags: ["A/B Testing"]
---

# List A/B tests

`GET /api/v1/ab-tests`

## Request

- Base URL: `https://api.misar.io/mail`
- URL: `https://api.misar.io/mail/api/v1/ab-tests`
- Auth: HTTP bearer

Returns all A/B tests for campaigns owned by the authenticated user.

## Query parameters

- `campaign_id` string, uuid
- `status` 'running' | 'completed' | 'cancelled'
- `page` integer
- `limit` integer

## Response `200`

A/B test list

- object
  - `success` boolean
  - `data` AbTest[]
    - `id` string, uuid
    - `campaign_id` string, uuid
    - `variant` string
    - `test_type` 'content' | 'subject' | 'send_time' | 'from_name' | 'preheader'
    - `subject` string, nullable
    - `preheader` string, nullable
    - `body_html` string, nullable
    - `from_name` string, nullable
    - `send_percent` integer
    - `emails_sent` integer
    - `opens` integer
    - `clicks` integer
    - `auto_select_winner` boolean
    - `winner_wait_hours` integer
    - `winner_selected_at` string, date-time, nullable
    - `created_at` string, date-time
  - `total` integer

## Other responses

- `401`: Invalid API key
- `403`: Insufficient scope — requires read, send, or send:marketing

---

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