Create an export job

curl --request POST \
  --url https://api.abconvert.io/v1/experiments/{id}/exports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "date_range": {
    "gte": "2026-08-01",
    "lte": "2026-08-15"
  },
  "sample_basis": "assignment"
}
'

import requests

url = "https://api.abconvert.io/v1/experiments/{id}/exports"

payload = {
    "date_range": {
        "gte": "2026-08-01",
        "lte": "2026-08-15"
    },
    "sample_basis": "assignment"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({date_range: {gte: '2026-08-01', lte: '2026-08-15'}, sample_basis: 'assignment'})
};

fetch('https://api.abconvert.io/v1/experiments/{id}/exports', 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/{id}/exports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'date_range' => [
        'gte' => '2026-08-01',
        'lte' => '2026-08-15'
    ],
    'sample_basis' => 'assignment'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.abconvert.io/v1/experiments/{id}/exports"

	payload := strings.NewReader("{\n  \"date_range\": {\n    \"gte\": \"2026-08-01\",\n    \"lte\": \"2026-08-15\"\n  },\n  \"sample_basis\": \"assignment\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.abconvert.io/v1/experiments/{id}/exports")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"date_range\": {\n    \"gte\": \"2026-08-01\",\n    \"lte\": \"2026-08-15\"\n  },\n  \"sample_basis\": \"assignment\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.abconvert.io/v1/experiments/{id}/exports")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"date_range\": {\n    \"gte\": \"2026-08-01\",\n    \"lte\": \"2026-08-15\"\n  },\n  \"sample_basis\": \"assignment\"\n}"

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

{
  "object": "export",
  "id": "export_9f2c1a7b3d5e4f60a1b2c3d4e5f60718",
  "status": "completed",
  "experiment_id": "3021",
  "url": "https://app.abconvert.io/v1/exports/export_9f2c1a7b3d5e4f60a1b2c3d4e5f60718/download?expires=1787000000&signature=3f8c1d0b6a94e27d5c1b8e40f7a2d9c6b3e15f8a0d47c92e6b1a3f5d8c07e246",
  "expires_at": "2023-11-07T05:31:56Z",
  "failure_reason": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}

{
  "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>"
      }
    ]
  }
}

{
  "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>"
      }
    ]
  }
}

Exports

Create an export job

Starts an export of the test’s order-level data for a date range. The job runs asynchronously, so poll GET /exports/{id} until it completes, then fetch the file from the url that job carries. The cookbook’s order export runs the whole flow, download and analysis included.

Each row carries the same columns as the ABConvert admin’s order export. That column schema is in beta.

The export is cut the same way the Analytics dashboard cuts its numbers, so the two reconcile: your configured outlier filter is applied automatically, and sample_basis chooses the same denominator the dashboard offers. The export isn’t capped, so a wide date range returns every attributed order.

A test that hasn’t started yet returns 422 export_not_available: nothing exists to export until it has run.

A read_experiments token may call this: it downloads data and changes nothing about the test. It still spends write budget and is recorded in the audit log, because it exports order-level data in bulk.

POST

experiments

{id}

exports

Create an export job

curl --request POST \
  --url https://api.abconvert.io/v1/experiments/{id}/exports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "date_range": {
    "gte": "2026-08-01",
    "lte": "2026-08-15"
  },
  "sample_basis": "assignment"
}
'

import requests

url = "https://api.abconvert.io/v1/experiments/{id}/exports"

payload = {
    "date_range": {
        "gte": "2026-08-01",
        "lte": "2026-08-15"
    },
    "sample_basis": "assignment"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({date_range: {gte: '2026-08-01', lte: '2026-08-15'}, sample_basis: 'assignment'})
};

fetch('https://api.abconvert.io/v1/experiments/{id}/exports', 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/{id}/exports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'date_range' => [
        'gte' => '2026-08-01',
        'lte' => '2026-08-15'
    ],
    'sample_basis' => 'assignment'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.abconvert.io/v1/experiments/{id}/exports"

	payload := strings.NewReader("{\n  \"date_range\": {\n    \"gte\": \"2026-08-01\",\n    \"lte\": \"2026-08-15\"\n  },\n  \"sample_basis\": \"assignment\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.abconvert.io/v1/experiments/{id}/exports")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"date_range\": {\n    \"gte\": \"2026-08-01\",\n    \"lte\": \"2026-08-15\"\n  },\n  \"sample_basis\": \"assignment\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.abconvert.io/v1/experiments/{id}/exports")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"date_range\": {\n    \"gte\": \"2026-08-01\",\n    \"lte\": \"2026-08-15\"\n  },\n  \"sample_basis\": \"assignment\"\n}"

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

{
  "object": "export",
  "id": "export_9f2c1a7b3d5e4f60a1b2c3d4e5f60718",
  "status": "completed",
  "experiment_id": "3021",
  "url": "https://app.abconvert.io/v1/exports/export_9f2c1a7b3d5e4f60a1b2c3d4e5f60718/download?expires=1787000000&signature=3f8c1d0b6a94e27d5c1b8e40f7a2d9c6b3e15f8a0d47c92e6b1a3f5d8c07e246",
  "expires_at": "2023-11-07T05:31:56Z",
  "failure_reason": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}

{
  "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>"
      }
    ]
  }
}

{
  "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.

Headers

Idempotency-Key

string

Replaying a request with the same key returns the original response instead of creating a second resource. Reusing a key with a different body returns 409 idempotency_key_in_use, and a key outside 1-255 characters returns 400 invalid_idempotency_key rather than being ignored. See Idempotency.

Required string length: 1 - 255

Path Parameters

string

required

The test's numeric ID as a string, for example "3021".

Pattern: ^[0-9]+$

Example:

"3021"

Body

application/json

Beta. More filters may be added later. An unknown field at the top level is refused with 400 unknown_parameter rather than ignored; an unknown key inside date_range is refused with 422 invalid_date_range.

date_range

object

required

Both bounds are required and inclusive, and are calendar days in your store's timezone.

The window is narrowed to the days that can hold data: it starts no earlier than the day the test started, and ends no later than today. A window that can hold nothing at all returns 422 date_range_out_of_bounds.

Show child attributes

sample_basis

enum<string>

default:assignment

Which visitors count. assignment includes every visitor put in a test group; exposure only those the test actually reached.

Available options:

assignment,

exposure

Response

The created job.

object

string

required

Allowed value: "export"

string

required

Treat as opaque. Never parse it.

Example:

"export_9f2c1a7b3d5e4f60a1b2c3d4e5f60718"

status

enum<string>

required

Available options:

pending,

processing,

completed,

failed

Example:

"completed"

experiment_id

string

Example:

"3021"

url

string<uri> | null

The signed download link, ready to fetch as given. Set while the job is completed and expires_at is still in the future; null before the job finishes, and null again once the link expires, while status stays completed. Branch on this field rather than on status.

The link is signed, so fetching it needs no bearer token. You can hand the whole URL to a browser or a download tool. Anyone who has the URL can download the file until expires_at.

Example:

"https://app.abconvert.io/v1/exports/export_9f2c1a7b3d5e4f60a1b2c3d4e5f60718/download?expires=1787000000&signature=3f8c1d0b6a94e27d5c1b8e40f7a2d9c6b3e15f8a0d47c92e6b1a3f5d8c07e246"

expires_at

string<date-time> | null

failure_reason

string | null

Why the job failed. Set only when status is failed.

created_at

string<date-time>

⌘I

Overview

Tests

Lifecycle

Schedule

Results

Exports

Create an export job

Authorizations

Headers

Path Parameters

Body

Response