List Optimizations | Webflow Developer Documentation

curl -G https://api.webflow.com/beta/optimize/117420042/optimizations \
     -H "Authorization: Bearer <token>" \
     -d status=live \
     -d status=draft \
     -d pageSize=100 \
     -d cursor=c2xhcnRpYmFydGZhc3Q

{
  "optimizations": [
    {
      "optimizationId": "417200971",
      "name": "Don't Panic hero headline",
      "optimizationType": "test",
      "status": "live",
      "variationCount": 2,
      "intervals": [
        {
          "start": "2026-07-01T16:00:00.000Z",
          "goals": [
            {
              "goalId": "198042420",
              "name": "AutoGoal: click engagement",
              "isPrimary": true,
              "metricType": "conversion",
              "scope": "session",
              "countingMethod": "unique"
            }
          ],
          "end": "2026-08-15T17:30:00.000Z"
        },
        {
          "start": "2026-08-15T17:30:00.000Z",
          "goals": [
            {
              "goalId": "198042421",
              "name": "Towel purchase",
              "isPrimary": true,
              "metricType": "value",
              "scope": "session",
              "countingMethod": "unique"
            },
            {
              "goalId": "198042420",
              "name": "AutoGoal: click engagement",
              "isPrimary": false,
              "metricType": "conversion",
              "scope": "session",
              "countingMethod": "unique"
            }
          ]
        }
      ],
      "updatedAt": "2026-08-15T17:31:12.518Z"
    },
    {
      "optimizationId": "417200972",
      "name": "Welcome back, hoopy froods",
      "optimizationType": "personalize",
      "status": "live",
      "variationCount": 2,
      "intervals": [
        {
          "start": "2026-06-01T15:02:51.000Z",
          "goals": [
            {
              "goalId": "198042424",
              "name": "AutoGoal: On-page engagement",
              "isPrimary": true,
              "metricType": "conversion",
              "scope": "session",
              "countingMethod": "unique"
            }
          ]
        }
      ],
      "updatedAt": "2026-06-01T15:02:47.206Z"
    },
    {
      "optimizationId": "417200973",
      "name": "Babel fish pricing page",
      "optimizationType": "aiOptimize",
      "status": "draft",
      "variationCount": 0,
      "intervals": []
    }
  ],
  "status": [
    "live",
    "draft"
  ],
  "nextCursor": "c2xhcnRpYmFydGZhc3Q"
}

Lists the optimizations for an optimizeId, with each one’s type, status, and intervals. Returns live and draft optimizations unless you set status.

Each report covers a date range within a single interval of an optimization. Use an interval’s start and end to choose a report’s intervalStart and intervalEnd.

Results are sorted by optimizationId, and each optimization’s intervals are listed oldest first. To get the next page, pass nextCursor as cursor.

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

Lists the optimizations for an `optimizeId`, with each one's type, status, and intervals. Returns live and draft optimizations unless you set `status`. Each report covers a date range within a single interval of an optimization. Use an interval's `start` and `end` to choose a report's `intervalStart` and `intervalEnd`. Results are sorted by `optimizationId`, and each optimization's intervals are listed oldest first. To get the next page, pass `nextCursor` as `cursor`. <Warning title="Optimize required">This endpoint requires a Webflow site with the Optimize add-on, or a non-Webflow site that uses Optimize.</Warning> <Note title="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.</Note> 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.

Query parameters

statuslist of enumsOptionalDefaults to ["live","draft"]

The statuses to include. Defaults to live and draft. Pass repeated values (status=live&status=draft) or a comma-separated list (status=live,draft).

A cursor keeps the statuses it was created with. When you pass a cursor, omit status or send the same statuses.

The statuses to include. Defaults to `live` and `draft`. Pass repeated values (`status=live&status=draft`) or a comma-separated list (`status=live,draft`). A `cursor` keeps the statuses it was created with. When you pass a `cursor`, omit `status` or send the same statuses.

Allowed values:

pageSizeintegerOptional1-200Defaults to 100

The maximum number of results to return. Defaults to 100, up to 200.

cursorstringOptional>=1 character

The nextCursor from a previous response, to get the next page.

Response

A page of optimizations.

optimizationslist of objects

The optimizations on this page, sorted by optimizationId.

statuslist of enums

The statuses this list includes.

Allowed values:

nextCursorstringOptional

Pass this value as cursor to get the next page. Omitted on the last page.

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