list_experiments
List the organization’s autonomous creative experiments (A/B tests Adlyse launched and monitors), newest first — the dashboard’s Experiments page as data. Money fields are dollars.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
live_only | boolean | no | false | Only experiments still running/paused/launching |
status | string | no | Exact status filter (e.g. running, paused, completed) | |
limit | integer | no | 25 | Max experiments (max 100) |
offset | integer | no | 0 | Pagination offset |
Returns#
json
{
"experiments": [
{
"id": "exp_abc123",
"name": "Hook test — summer hero",
"platform": "meta_ads",
"topology": "adset_per_arm",
"status": "running",
"stopped_reason": null,
"ad_account_id": "ad_acct_abc123",
"total_daily_budget_usd": 60.0,
"budget_cap_usd": 500.0,
"spend_to_date_usd": 214.6,
"spend_as_of": "2026-07-12",
"started_at": "2026-07-01T09:00:00+00:00",
"ends_at": "2026-07-15T09:00:00+00:00",
"paused_at": null,
"winner_arm": null,
"created_at": "2026-06-30T18:22:00+00:00"
}
],
"total": 4,
"offset": 0,
"limit": 25,
"has_more": false,
"source": "adlyse.experiments@v1"
}Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid API key |