Garasu
DocsMarkdown

get_experiment

Get an experiment by id.

Operation ID: get_experiment

Get an experiment by id.

When to use: You have an experiment_id and need the saved experiment, including raw results.

Returns: { id, project_id, name, hypothesis, start_date, end_date, variant_keys, control_variant_key, metadata, headline, processed_results, related_learning_ids, related_learnings, raw_results, created_at, updated_at, source_url }

FieldTypeRequiredDescription
experiment_iduuidYesExperiment id from import_experiment, list_experiments, or query_experiments.

Function schema:

{
  "name": "get_experiment",
  "description": "Get an experiment by id. You have an experiment_id and need the saved experiment, including raw results.",
  "parameters": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "experiment_id": {
        "type": "string",
        "format": "uuid",
        "description": "Experiment id from import_experiment, list_experiments, or query_experiments."
      }
    },
    "required": [
      "experiment_id"
    ]
  }
}

Request:

{
  "experiment_id": "22222222-2222-4222-8222-222222222222"
}

Response:

{
  "id": "22222222-2222-4222-8222-222222222222",
  "project_id": "11111111-1111-4111-8111-111111111111",
  "name": "Cart shipping estimate",
  "hypothesis": "If we show an estimated shipping range on cart, checkout completion will go up because people stop getting surprised by cost at payment.",
  "start_date": "2026-03-01",
  "end_date": "2026-03-28",
  "variant_keys": [
    "control",
    "estimate"
  ],
  "control_variant_key": "control",
  "metadata": {
    "source": "posthog",
    "source_id": "cart-shipping-estimate"
  },
  "headline": {
    "metric": "Checkout completion",
    "variant_key": "estimate",
    "lift_relative": 7.2993,
    "p_value": 0.1389,
    "control_n": 24105,
    "variant_n": 24105
  },
  "processed_results": [
    {
      "metric": "Checkout completion",
      "variant_key": "estimate",
      "control_variant_key": "control",
      "control_n": 24105,
      "variant_n": 24105,
      "control_mean": 0.034101,
      "variant_mean": 0.03659,
      "lift_absolute": 0.002489,
      "lift_relative": 7.2993,
      "p_value": 0.1389,
      "z_score": 1.4799,
      "post_hoc_power": 32,
      "mde80_relative": 13.8182,
      "kind": "rate",
      "control_variance": 0.032939,
      "variant_variance": 0.035251
    }
  ],
  "related_learning_ids": [
    "44444444-4444-4444-8444-444444444444",
    "55555555-5555-4555-8555-555555555555"
  ],
  "related_learnings": [
    {
      "id": "44444444-4444-4444-8444-444444444444",
      "title": "Shipping estimates lift checkout completion",
      "summary": "Showing an estimated shipping range on cart raised checkout completion. People dropped off when cost appeared for the first time at payment.",
      "strength_of_evidence": 0.72,
      "source_url": "https://garasu.co/app/77777777-7777-4777-8777-777777777777/projects/11111111-1111-4111-8111-111111111111/learnings/44444444-4444-4444-8444-444444444444"
    }
  ],
  "source_url": "https://garasu.co/app/77777777-7777-4777-8777-777777777777/projects/11111111-1111-4111-8111-111111111111/experiments/22222222-2222-4222-8222-222222222222",
  "created_at": "2026-03-29T14:12:00.000Z",
  "updated_at": "2026-03-29T14:12:00.000Z",
  "raw_results": [
    {
      "metric": "Checkout completion",
      "variant_key": "control",
      "users": 24105,
      "conversions": 822
    },
    {
      "metric": "Checkout completion",
      "variant_key": "estimate",
      "users": 24105,
      "conversions": 882
    }
  ]
}