Amplitude · JSON Structure

Experiment Evaluation Api Evaluation Response Structure

A map of flag keys to variant objects representing the evaluated variant assignments for the user.

Type: object Properties: 0
A/B TestingAnalyticsExperimentationFeature FlagsProduct AnalyticsUser Behavior

EvaluationResponse is a JSON Structure definition published by Amplitude. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amplitude/refs/heads/main/json-structure/experiment-evaluation-api-evaluation-response-structure.json",
  "name": "EvaluationResponse",
  "description": "A map of flag keys to variant objects representing the evaluated variant assignments for the user.",
  "type": "object",
  "additionalProperties": {
    "type": "object",
    "properties": {
      "key": {
        "type": "string",
        "description": "The variant key identifying this variant."
      },
      "value": {
        "type": "string",
        "description": "The variant value or payload."
      },
      "payload": {
        "description": "An optional JSON payload associated with the variant."
      },
      "metadata": {
        "type": "object",
        "description": "Metadata about the variant assignment.",
        "properties": {
          "experimentKey": {
            "type": "string",
            "description": "The key of the experiment that assigned this variant."
          },
          "flagType": {
            "type": "string",
            "description": "The type of flag, such as experiment or release."
          },
          "flagVersion": {
            "type": "int32",
            "description": "The version of the flag configuration."
          },
          "default": {
            "type": "boolean",
            "description": "Whether this is the default variant."
          }
        }
      }
    }
  }
}