> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Experiment

> Read a native Meta A/B experiment or ad study, its test cells and available measurement results

Read a native Meta A/B experiment or ad study, its test cells and available measurement results. Meta may return no results for pending or unsupported measurements; missing results do not establish a winner.

|                      |                           |
| -------------------- | ------------------------- |
| **App**              | Meta Ads                  |
| **Operation ID**     | `meta_ads_get_experiment` |
| **Type**             | Action                    |
| **Connection**       | `meta_ads` (required)     |
| **Credits per run**  | 1                         |
| **Agent / MCP tool** | Yes                       |

## Inputs

| Field             | Type                 | Required | Default | Description                                                                                                                                                                                                  |
| ----------------- | -------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `experiment_id`   | string or SelectItem | Yes      | -       | Meta ad study ID from meta\_ads\_create\_experiment or meta\_ads\_list\_experiments.                                                                                                                         |
| `include_results` | boolean              | No       | `True`  | Include available Meta measurement results on the study objectives. Defaults to true. Meta may return no results for pending studies or unsupported measurements; missing results do not establish a winner. |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

## Output

**Type**: `Dict`

Returns study metadata plus paginated cells and objectives. Objective results are included when requested and supplied by Meta, without inferring significance or a winner.

**Fields**: `id`, `name`, `type`, `start_time`, `end_time`, `cells`, `objectives`