Skip to content
AdlyseDocs
Product guideMCP reference
⌘K
Open Adlyse
⌘K
Overview
QuickstartAuthentication
adlyse-insights
adlyse-ads
list_ad_accountsget_platform_supportget_ad_creation_capabilitiesget_ad_build_specupdate_ad_build_speclist_ad_plansget_ad_plan_publicationget_ad_planimport_ad_to_planimport_live_ad_to_plancreate_ad_plan_variantsadd_ad_plan_variantsupdate_ad_plan_groupgroup_ad_plansget_ad_plan_groupfreeze_ad_plan_grouppublish_ad_plan_groupcreate_ad_plancreate_ad_edit_planupdate_ad_planattach_ad_plan_assetfill_ad_plan_slotsfreeze_ad_planpublish_ad_planresolve_ad_publish_steplist_campaignsget_performancelist_change_eventslist_adsget_ad_performancelist_creative_librarylist_experimentsget_experimentpause_experimentresume_experimentstop_experimentpause_creative_adsupdate_ad_group_statusupdate_ad_statusupdate_campaign_statusupdate_campaign_budgetlist_swipe_filesave_competitor_ad_to_swipe_filesave_creative_to_swipe_fileremix_from_swipe_filestart_creative_jobresize_creativemake_variants_of_winnerget_creative_jobestimate_creative_batchstart_creative_batchbatch_to_plan_groupget_creative_batchsnapshot_catalog_productsgenerate_ad_copylist_ad_copycreate_creative_conceptrequest_creative_reviewget_creative_review
adlyse-workflows
adlyse-admin
adlyse-all
  1. Overview
  2. adlyse-ads

get_experiment

One experiment in full detail: summary fields plus per-arm budgets, launch state, and metrics, and the final report when the experiment concluded.

Parameters#

NameTypeRequiredDescription
experiment_idstringyesThe experiment id (from list_experiments)

Returns#

json
{
  "experiment": {
    "id": "exp_abc123",
    "name": "Hook test — summer hero",
    "status": "running",
    "arms": [
      {
        "index": 0,
        "name": "Control",
        "is_control": true,
        "status": "active",
        "creative_id": "ad_crtv_abc123",
        "daily_budget_usd": 30.0,
        "launched_at": "2026-07-01T09:05:00+00:00",
        "launch_error": null,
        "platform_issue": null,
        "metrics": { "impressions": 41000, "clicks": 520, "spend_usd": 108.2 }
      }
    ],
    "final_report": {}
  },
  "source": "adlyse.experiments@v1"
}

(Summary fields match list_experiments; final_report is empty until the experiment concludes.)

Errors#

error_typeWhen
auth_errorMissing / invalid API key
not_foundNo experiment with that id in your org
Previouslist_experimentsNextpause_experiment