Overview

The External API gives your own tools read-only access to your store's experiments and their results: the same numbers and statistics you see in Elevate. Use it to feed a data warehouse, build internal dashboards, post results to Slack or give an AI agent live experiment data.

https://elevateab.app/api/external/v1

Every endpoint is a GET and returns JSON. The API reference has them all.

Get started

1

Create a key

In Elevate, go to Settings → MCP & API and click Generate API Key in the External API card. Copy it: it starts with elv_ and is only shown once.

2

Find an experiment

curl "https://elevateab.app/api/external/v1/experiments?status=running" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "items": [
      {
        "testId": "3f2a9c1e-5b7d-4e8a-9f10-2c4d6e8a0b12",
        "name": "Homepage hero",
        "status": "Running",
        "goal": "CONVERSION_RATE"
      }
    ],
    "pagination": { "page": 1, "limit": 20, "total": 1, "hasNextPage": false }
  }
}

3

Get its results

curl https://elevateab.app/api/external/v1/experiments/3f2a9c1e-5b7d-4e8a-9f10-2c4d6e8a0b12/summary \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "goal": "CONVERSION_RATE",
    "currency": "USD",
    "totals": { "uniqueVisitors": 20450 },
    "variations": [
      {
        "name": "Control",
        "isControl": true,
        "uniqueVisitors": 10240,
        "conversionRate": 3.1,
        "revenuePerVisitor": 2.04
      },
      {
        "name": "Variation 1",
        "isControl": false,
        "uniqueVisitors": 10210,
        "conversionRate": 3.4,
        "revenuePerVisitor": 2.21
      }
    ],
    "statistics": { "status": "Trending Positive" }
  }
}

Some fields are left out above. Every field is in the API reference.

Next

• API reference: every endpoint, with examples and caveats.

• Statistics: how to read the status, the winner and probabilities.

• Filters: narrow results to a device, country or campaign.

The API is read-only: it cannot create, edit, start or stop experiments.