List tests

curl --request GET \
  --url https://api.abconvert.io/v1/experiments \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.abconvert.io/v1/experiments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.abconvert.io/v1/experiments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.abconvert.io/v1/experiments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.abconvert.io/v1/experiments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "object": "experiment",
      "id": "3021",
      "type": "price",
      "status": "active",
      "name": "Summer price test",
      "hypothesis": "A 10% higher price will not hurt conversion.",
      "primary_metric": "revenue_per_visitor",
      "traffic_allocation": 100,
      "test_groups": [
        {
          "name": "Control",
          "control": true,
          "split": 50
        },
        {
          "name": "Variant A",
          "control": false,
          "split": 50
        }
      ],
      "schedule": {
        "start_at": "2026-08-02T09:00:00Z",
        "end_at": "2026-08-16T09:00:00Z"
      },
      "has_force_assign_rules": false,
      "assignment_version": 0,
      "created_at": "2026-08-01T09:00:00Z",
      "updated_at": "2026-08-02T09:00:00Z",
      "started_at": "2026-08-02T09:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "cur_9f2c1a7b3d5e"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

Tests

List tests

Returns a cursor-paginated page of tests, and omits archived tests unless you pass status=archived.

Send each parameter at most once. A repeated name returns 400 invalid_request, and an unrecognized one returns 400 unknown_parameter.

Each test’s test_groups carry identity only: name, control, and split, never changes. Fetch a test by ID to read its changes.

A runnable example: the cookbook’s portfolio dashboard pages through this list with ?include=results_summary for every store you hold a token for.

GET

experiments

List tests

curl --request GET \
  --url https://api.abconvert.io/v1/experiments \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.abconvert.io/v1/experiments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.abconvert.io/v1/experiments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.abconvert.io/v1/experiments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.abconvert.io/v1/experiments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "object": "experiment",
      "id": "3021",
      "type": "price",
      "status": "active",
      "name": "Summer price test",
      "hypothesis": "A 10% higher price will not hurt conversion.",
      "primary_metric": "revenue_per_visitor",
      "traffic_allocation": 100,
      "test_groups": [
        {
          "name": "Control",
          "control": true,
          "split": 50
        },
        {
          "name": "Variant A",
          "control": false,
          "split": 50
        }
      ],
      "schedule": {
        "start_at": "2026-08-02T09:00:00Z",
        "end_at": "2026-08-16T09:00:00Z"
      },
      "has_force_assign_rules": false,
      "assignment_version": 0,
      "created_at": "2026-08-01T09:00:00Z",
      "updated_at": "2026-08-02T09:00:00Z",
      "started_at": "2026-08-02T09:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "cur_9f2c1a7b3d5e"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "details": {},
    "findings": [
      {
        "severity": "error",
        "code": "product_not_found",
        "message": "<string>",
        "param": "<string>"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer tokens created in the ABConvert admin under Settings → MCP & API Access. Scopes: read_experiments and write_experiments (write implies read; the default is read). See Authentication for which scope each request needs.

Query Parameters

status

enum<string>

Return only tests in this status. The test's current status. The ABConvert admin labels ended as Closed; the wire value stays ended. Scheduling isn't a status: a scheduled test is a draft or preview with a schedule.

Available options:

draft,

preview,

active,

paused,

ended,

failed,

archived

type

enum<string>

Return only tests of this type. What the test changes: product prices, shipping rates, the theme a visitor sees, a page template, the URL a visitor lands on, checkout delivery and payment methods, or a cart offer. visual_editor is a storefront edit: custom CSS and JavaScript, which you can write here, alongside DOM changes authored in the ABConvert visual editor. combined bundles more than one change type in one test. See CreatableExperimentType for the ones you can create here.

Available options:

price,

shipping,

theme,

template,

url_redirect,

checkout,

offer,

visual_editor,

combined

created_at[gte]

string<date-time>

Return only tests created at or after this timestamp. Send an RFC 3339 date-time carrying Z or a UTC offset (2026-01-01T00:00:00Z, 2026-01-01T09:00:00+09:00), or a bare date (2026-01-01), which is read as UTC midnight. Anything else returns 422, including a date the calendar doesn't have and a leap-second :60.

created_at[lte]

string<date-time>

Return only tests created at or before this timestamp. Same accepted spellings as created_at[gte].

scheduled

enum<string>

Set to true to return only the tests waiting to launch on their own: draft and preview tests whose schedule.start_at is in the future.

This is a derived filter, not a status. Each test still reports its real status.

Only true narrows. false is accepted and changes nothing, so you can pass a flag straight through. Any other value returns 422.

Available options:

true,

false

include

enum<string>

Comma-separated expansions to inline. results_summary is the only value. An unknown value returns 400 invalid_include.

Available options:

results_summary

cursor

string

Opaque cursor from a previous page's next_cursor.

limit

integer

default:20

How many tests to return on this page, 1 to 100. Defaults to 20. Anything else returns 400 invalid_request with param set to limit.

Required range: 1 <= x <= 100

Response

A page of tests.

object

string

required

Allowed value: "list"

data

object[]

required

Show child attributes

has_more

boolean

required

next_cursor

string | null

required

Pass this value as ?cursor= to fetch the next page. Null on the last page.

⌘I

Overview

Tests

Lifecycle

Schedule

Results

Exports

List tests

Authorizations

Query Parameters

Response