---
updatedAt: 2026-05-20T20:59:45.000Z
agentTools:
  projectIndex: https://docs.developers.convert.com/llms.txt
---

# Get daily traffic allocation report for an MAB experience

Retrieves the day-by-day traffic allocation percentages for each variation in an experience that uses Multi-Armed Bandit (MAB) or auto-allocation.
This shows how Convert dynamically shifted traffic towards better-performing variations over time.
The Knowledge Base article "Multi-Armed Bandit (MAB) & Auto-Allocation in Convert" explains this feature.


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Convert Management API",
    "description": "Move your app forward with the Convert API. The Convert API allows\nyou to manage your Convert Experiences projects using code. The REST API is\nan interface for managing and extending functionality of Convert. For\nexample, instead of creating and maintaining projects using the Convert\nExperiences web dashboard you can create an experiment programmatically.\nAdditionally, if you prefer to run custom analysis on experiment results you\ncan leverage the API to pull data from Convert Experiences into your own\nworkflow. If you do not have a Convert account already, sign up for a free\ndeveloper account at https://www.convert.com/api/.\n\n*[Convert API V1](/doc/v1) is still available and documentation can be found [here](/doc/v1) but using it is highly discouraged\nas it will be phased out in the future*\n",
    "version": "2.0.0"
  },
  "x-tagGroups": [
    {
      "name": "Client Authentication",
      "tags": [
        "API KEY Authentication",
        "Cookie Authentication",
        "OAuth Authorization"
      ]
    },
    {
      "name": "Common Parameters",
      "tags": [
        "Optional Fields",
        "Expandable Fields"
      ]
    },
    {
      "name": "Requests",
      "tags": [
        "User",
        "Accounts",
        "AI content",
        "Collaborators",
        "API Keys",
        "Notifications",
        "Projects",
        "SDK Keys",
        "Experiences",
        "Experience Variations",
        "Experience Sections",
        "Section Versions",
        "Version Changes",
        "Experiences Reports",
        "Experiences Heatmaps",
        "Goals",
        "Hypotheses",
        "Knowledge Bases",
        "Observations",
        "Locations",
        "Audiences",
        "Domains",
        "Cdn Images",
        "Files",
        "Tags",
        "Features",
        "Visitor Insights",
        "Visitors Data",
        "Visitor Data Placeholders",
        "OAuth",
        "Approval Requests"
      ]
    }
  ],
  "tags": [
    {
      "name": "Experiences Reports",
      "description": "Specification for different reports data that can be retrieved for experiences"
    }
  ],
  "paths": {
    "/accounts/{account_id}/projects/{project_id}/experiences/{experience_id}/daily_traffic_allocation": {
      "post": {
        "operationId": "getExperienceDailyTrafficAllocation",
        "x-mutates": false,
        "summary": "Get daily traffic allocation report for an MAB experience",
        "description": "Retrieves the day-by-day traffic allocation percentages for each variation in an experience that uses Multi-Armed Bandit (MAB) or auto-allocation.\nThis shows how Convert dynamically shifted traffic towards better-performing variations over time.\nThe Knowledge Base article \"Multi-Armed Bandit (MAB) & Auto-Allocation in Convert\" explains this feature.\n",
        "tags": [
          "Experiences Reports"
        ],
        "parameters": [
          {
            "name": "account_id",
            "in": "path",
            "required": true,
            "description": "ID of the account that owns the retrieved/saved data",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "project_id",
            "description": "ID of the project to which save/retrieved data is connected",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          },
          {
            "name": "experience_id",
            "in": "path",
            "required": true,
            "description": "ID of the experience",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "report_token",
            "in": "header",
            "required": false,
            "description": "Token to access the experience report in read-only mode.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/GetExperienceDailyTrafficAllocationRequest"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ExperienceDailyTrafficAllocationResponse"
          },
          "403": {
            "$ref": "#/components/responses/AccountArchivedResponse"
          },
          "503": {
            "$ref": "#/components/responses/AccountDirectoryUnavailableResponse"
          },
          "default": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.convert.com/api/v2",
      "description": "Live API server"
    },
    {
      "url": "https://apidev.convert.com/api/v2",
      "description": "DEV API server"
    },
    {
      "url": "http://apidev.convert.com:5000/api/v2",
      "description": "DEV mocked API server"
    }
  ],
  "components": {
    "securitySchemes": {
      "secretKey": {
        "type": "http",
        "scheme": "bearer",
        "description": "See **[API Key Authentication](/reference/api-key-authentication)** for more information.\n"
      },
      "cookieAuthentication": {
        "type": "apiKey",
        "in": "cookie",
        "name": "sid",
        "description": "Cookie authentication is used against Convert's own IdentityProvider  or third party identity providers and is described more in the \"[Cookie Authentication](/reference/cookie-authentication)\" section"
      },
      "requestSigningAppId": {
        "type": "apiKey",
        "in": "header",
        "name": "Convert-Application-ID",
        "description": "HMAC request signing — the Application ID from your Convert account. See **[API Key Authentication](/reference/api-key-authentication)** for how to generate the full three-header set."
      },
      "requestSigningExpires": {
        "type": "apiKey",
        "in": "header",
        "name": "Expires",
        "description": "HMAC request signing — UNIX timestamp after which the signature expires. See **[API Key Authentication](/reference/api-key-authentication)** for how to compute it."
      },
      "requestSigningAuthorization": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "description": "HMAC request signing — format: `Convert-HMAC-SHA256 Signature=<hex-hmac-sha256(AppID\\nExpires\\nURL\\nBody, Secret)>`. See **[API Key Authentication](/reference/api-key-authentication)** for the signing algorithm. The \"Try It\" playground cannot compute this for you; paste a pre-computed signature here or use the Bearer method instead."
      }
    },
    "requestBodies": {
      "GetExperienceDailyTrafficAllocationRequest": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/GetExperienceDailyTrafficAllocationRequestData"
            }
          }
        },
        "description": "Parameters to specify the date range (`start_time`, `end_time`, `utc_offset`) for retrieving the daily traffic allocation data, typically for experiences using Multi-Armed Bandit (MAB) strategies.\n"
      }
    },
    "responses": {
      "ExperienceDailyTrafficAllocationResponse": {
        "description": "For experiences using Multi-Armed Bandit (MAB), this shows the daily percentage of traffic allocated to each variation over time, illustrating how the MAB strategy adapted.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ExperienceDailyTrafficAllocationResponseData"
            }
          }
        }
      },
      "ErrorResponse": {
        "description": "Indicates an error occurred while processing the request. The `code` provides an HTTP status code, `message` offers a human-readable explanation or an array of validation errors, and `fields` (if present) specifies which input fields were problematic.\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorData"
            }
          }
        }
      },
      "AccountArchivedResponse": {
        "description": "The request is refused because of the state of the account. The body is the standard error envelope with `code` 403, and `message` tells the two bodies apart.\n\n`ACCOUNT_ARCHIVED`: the account was archived and its database was dropped. A request for this account is refused when it uses an API key, HMAC-signed or sent as a Bearer API-key token. A request with an OAuth access token for an archived account gets 401 instead. A cookie session is refused when every account the user holds was archived. Changing the subscription of an archived account is refused too. Support restores such an account by hand.\n\n`This account has been offboarded and report data access is no longer available.`: the account was offboarded, and report data access is refused.\n\nOther 403 refusals, such as a missing permission, use the same envelope with their own `message`.\n",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorData"
            },
            "examples": {
              "accountArchived": {
                "summary": "The account was archived",
                "value": {
                  "code": 403,
                  "message": "ACCOUNT_ARCHIVED",
                  "isError": true
                }
              },
              "accountOffboarded": {
                "summary": "The account was offboarded",
                "value": {
                  "code": 403,
                  "message": "This account has been offboarded and report data access is no longer available."
                }
              }
            }
          }
        }
      },
      "AccountDirectoryUnavailableResponse": {
        "description": "The list of accounts the user holds could not be fetched, so the request cannot continue. Only cookie sessions receive this response. The client may retry after the number of seconds in the `Retry-After` header. The body is the standard error envelope with `code` 503 and `message` `ACCOUNT_DIRECTORY_UNAVAILABLE`.\n",
        "headers": {
          "Retry-After": {
            "description": "Seconds to wait before the client retries the request.",
            "schema": {
              "type": "integer"
            },
            "example": 5
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorData"
            },
            "example": {
              "code": 503,
              "message": "ACCOUNT_DIRECTORY_UNAVAILABLE"
            }
          }
        }
      }
    },
    "schemas": {
      "ErrorData": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          },
          "fields": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          },
          "context": {
            "type": "object",
            "description": "Additional context about the error."
          }
        }
      },
      "UTC_Offset": {
        "type": "integer",
        "description": "The time offset from Coordinated Universal Time (UTC) in seconds.\nFor example, UTC-5 (EST) would be -18000. UTC+2 would be 7200.\nUsed for interpreting or displaying date/time information according to a specific timezone.\n",
        "default": 0,
        "minimum": -43200,
        "maximum": 50400
      },
      "ConcurrencyKey": {
        "type": "string",
        "nullable": true,
        "description": "A server-generated hash that represents the object's state at the time of retrieval. When included in an update request, the operation will only succeed if the object hasn't been modified since this key was obtained. If another update has occurred in the meantime, the request will fail with a conflict error, requiring you to fetch the latest version and retry your update with the new concurrency_key. This implements optimistic concurrency control to prevent lost updates in concurrent scenarios."
      },
      "ExperienceVariationStatuses": {
        "type": "string",
        "enum": [
          "stopped",
          "running"
        ]
      },
      "ExperienceVariationBase": {
        "type": "object",
        "properties": {
          "name": {
            "description": "A user-defined, friendly name for the variation (e.g., \"Original Homepage\", \"Variation B - Green Button\", \"Personalized Offer for New Users\"). This name appears in reports and the Convert UI.",
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "description": "An optional, more detailed explanation of what this variation entails or what changes it implements compared to the original or other variations.",
            "type": "string",
            "maxLength": 2000,
            "nullable": true
          },
          "is_baseline": {
            "type": "boolean",
            "description": "If `true`, this variation is considered the baseline (control) against which other variations in the experience are compared for performance.\nTypically, the \"Original\" variation is the baseline. Only one variation per experience can be the baseline.\nKnowledge Base: \"What is a Baseline?\"\n"
          },
          "traffic_distribution": {
            "description": "The percentage of eligible traffic allocated to this specific variation.\nThe sum of `traffic_distribution` for all active variations within an experience should ideally be 100% of the traffic allocated to the experience itself.\nFor Multi-Armed Bandit (MAB) experiences, this value may be dynamically adjusted by the system.\nKnowledge Base: \"What is an Traffic Distribution?\"\n",
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "multipleOf": 0.0001
          },
          "key": {
            "description": "A unique, machine-readable key or identifier for this variation within the project.\nOften auto-generated from the name if not specified, but can be user-defined for easier programmatic reference (e.g., in Full Stack SDKs).\nExample: \"control\", \"treatment_A\".\n",
            "type": "string",
            "maxLength": 32
          },
          "concurrency_key": {
            "$ref": "#/components/schemas/ConcurrencyKey"
          }
        }
      },
      "ExperienceVariationBaseExtended": {
        "allOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "description": "Variation unique ID",
                "type": "integer",
                "readOnly": true
              }
            }
          },
          {
            "$ref": "#/components/schemas/ExperienceVariationBase"
          },
          {
            "type": "object",
            "properties": {
              "status": {
                "$ref": "#/components/schemas/ExperienceVariationStatuses"
              }
            }
          }
        ]
      },
      "StatsDataPoint": {
        "type": "object",
        "description": "Represents a single data point in a time series, typically for a specific day.",
        "properties": {
          "timestamp": {
            "description": "Unix timestamp (UTC, seconds since epoch) representing the start of the day for this data point.",
            "type": "number"
          },
          "value": {
            "description": "The numerical value of the metric or statistic for this data point (e.g., daily conversion rate, daily visitor count).",
            "type": "number",
            "format": "double"
          }
        }
      },
      "ExperienceDailyTrafficAllocationReport": {
        "type": "object",
        "description": "Provides a day-by-day breakdown of traffic allocation percentages for each variation in an experience, typically used for MAB experiments.",
        "properties": {
          "variations_data": {
            "$ref": "#/components/schemas/ExperienceReportVariationsData"
          },
          "reportData": {
            "type": "object",
            "description": "Contains the daily traffic allocation data.",
            "properties": {
              "variations": {
                "type": "array",
                "description": "A list, where each item contains the daily traffic allocation data for one variation.",
                "items": {
                  "type": "object",
                  "description": "Daily traffic allocation for a single variation.",
                  "properties": {
                    "id": {
                      "description": "The unique numerical identifier of the variation.",
                      "type": "number"
                    },
                    "stats": {
                      "type": "array",
                      "description": "An array of data points, each representing the traffic allocation percentage for this variation on a specific day.",
                      "items": {
                        "$ref": "#/components/schemas/StatsDataPoint"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "ExperienceReportVariationsData": {
        "type": "array",
        "description": "An array containing basic identifying information for each variation in the experience (ID, name, baseline status, traffic distribution).",
        "items": {
          "$ref": "#/components/schemas/ExperienceVariationBaseExtended"
        }
      },
      "TimeRangeRequestData": {
        "type": "object",
        "description": "Parameters for defining a specific time range for report data retrieval.",
        "properties": {
          "utc_offset": {
            "$ref": "#/components/schemas/UTC_Offset"
          },
          "start_time": {
            "type": "number",
            "nullable": true,
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Unix timestamp (seconds since epoch) for the beginning of the reporting period. If null, data from the experience start is typically used. Should be interpreted with `utc_offset`."
          },
          "end_time": {
            "type": "number",
            "nullable": true,
            "minimum": 0,
            "maximum": 4294967295,
            "description": "Unix timestamp (seconds since epoch) for the end of thereporting period. If null, data up to the current time is typically used. Should be interpreted with `utc_offset`."
          }
        }
      },
      "GetExperienceDailyTrafficAllocationRequestData": {
        "allOf": [
          {
            "$ref": "#/components/schemas/TimeRangeRequestData"
          }
        ]
      },
      "ExperienceDailyTrafficAllocationResponseData": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ExperienceDailyTrafficAllocationReport"
          }
        }
      }
    }
  },
  "security": [
    {
      "requestSigningAppId": [],
      "requestSigningExpires": [],
      "requestSigningAuthorization": []
    },
    {
      "secretKey": []
    },
    {
      "cookieAuthentication": []
    }
  ]
}
```