Get Optimization Results | Webflow Developer Documentation

curl -G https://api.webflow.com/v2/optimize/117420042/optimizations/417200971/summary \
     -H "Authorization: Bearer <token>" \
     --data-urlencode intervalStart=2026-09-01T00:00:00Z \
     --data-urlencode intervalEnd=2026-09-15T00:00:00Z \
     -d goalId=198042421

{
  "report": "optimization_summary",
  "intervalStart": "2026-09-01T00:00:00.000Z",
  "intervalEnd": "2026-09-15T00:00:00.000Z",
  "goal": {
    "goalId": "198042421",
    "name": "Towel purchase"
  },
  "optimizationType": "test",
  "variations": [
    {
      "variationId": "617424201",
      "name": "Base variation",
      "sessions": 4100,
      "users": 3050,
      "conversions": 410,
      "conversionRate": 0.1,
      "value": 17220,
      "valuePerConversion": 42,
      "comparison": {
        "isBaseline": true
      }
    },
    {
      "variationId": "617424202",
      "name": "Don't Panic in large, friendly letters",
      "sessions": 4242,
      "users": 3120,
      "conversions": 506,
      "conversionRate": 0.1193,
      "value": 21252,
      "valuePerConversion": 42,
      "comparison": {
        "isBaseline": false,
        "isWinner": true,
        "lift": 0.193,
        "statisticalSignificance": 0.97
      }
    }
  ],
  "filter": {
    "country": {
      "name": "Country",
      "in": [
        "US",
        "GB"
      ]
    }
  }
}

Returns each variation’s sessions, users, conversions, and conversion rate for one goal, over a date range within one interval. Traditional tests and AI-optimized optimizations also include each variation’s comparison with the base variation.

Value goals also include each variation’s total value and average conversion value. Choose the goal with goalId, and narrow the results with filter.

Optimize required

This endpoint requires a Webflow site with the Optimize add-on, or a non-Webflow site that uses Optimize.

Concurrency limit: 1 request at a time

Each access token can have one Optimize request in flight at a time, across all Optimize endpoints. Additional concurrent requests return 429 Too Many Requests. Wait for your in-flight request to finish, or for the Retry-After interval, then retry.

Required scope | sites:read

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

optimize_idstringRequired>=1 character

The Optimize ID, from List Optimize IDs.

optimization_idstringRequired1-128 characters

The optimization ID, from List Optimizations.

Query parameters

intervalStartstringRequiredformat: "date-time"

Start of the date range. Must be a UTC timestamp ending in Z, such as 2026-09-01T00:00:00Z. Offsets and date-only values aren’t accepted. Seconds and milliseconds are optional. The date range must fall within a single interval of the optimization. A range that crosses from one interval into the next is rejected. Use an interval’s start and end from List Optimizations. Can’t be earlier than 18 months ago.

intervalEndstringRequiredformat: "date-time"

End of the date range. Must be a UTC timestamp ending in Z, such as 2026-09-15T00:00:00Z, and later than intervalStart. Offsets and date-only values aren’t accepted. Seconds and milliseconds are optional.

goalIdstringOptional1-128 characters

The goal to measure. Defaults to the interval’s first target goal, or its first goal if it has no target goal. Use a goalId from the interval’s goals or from the optimization’s currentGoals. See List Optimization Goals.

If the goal is in both lists, the report uses the interval’s version. A goal from currentGoals is measured with its current settings over the whole date range, including dates before it was added to the optimization.

filtermap from strings to objectsOptional

Narrow the results to visitors who match dimension values. Use bracket notation with in or nin and indexed arrays, for example filter[country][in][0]=US&filter[country][in][1]=GB&filter[customAttribute:towel][nin][0]=forgotten.

Keys are dimension id values from List Dimensions, and values are raw value values from List Dimension Values. Separate dimensions combine with AND. Values within one dimension combine with OR. A filter can name at most 20 dimensions, with at most 50 values per operator and 500 values in total.

Response

Each variation's results for the requested goal and date range.

reportenum

Identifies the report type.

Allowed values:

intervalStartstringformat: "date-time"

Start of the reported date range, in full form with milliseconds.

intervalEndstringformat: "date-time"

End of the reported date range, in full form with milliseconds.

goalobject

The goal the report measures. When the request omits goalId, this is the interval’s first target goal, or its first goal if it has no target goal.

optimizationTypeenum

The kind of optimization.

test: A traditional test. Randomly shows different versions of your content to a set percentage of your traffic. After enough traffic has seen the variations, a single winner is determined based on statistical significance.
personalize: A manual personalization. Uses rules-based personalization to define who should see which variation. Runs until you choose to stop it, and every visitor in the target segment consistently sees the same version of the page.
aiOptimize: An AI-optimized optimization. Uses AI to automatically deliver the best-performing variation to each visitor. As behavior shifts, the AI adapts in real time, learning which versions yield the most conversions.

Allowed values:

variationslist of objects

One entry per variation.

filtermap from strings to objectsOptional

The request’s filter, keyed by dimension id, with each dimension’s display name. Present only when the request included a filter.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error