# Get an experiment

Launch stage: GA

`GET /api/2.0/mlflow/experiments/get`

Gets metadata for an experiment. This method works on deleted experiments.

API scopes: mlflow

## Query parameters

- `experiment_id` (string, required)
  ID of the associated experiment.

## Returns

- `experiment` (object, optional)
  Experiment details.
  - `experiment_id` (string, optional)
    Unique identifier for the experiment.
  - `name` (string, optional)
    Name of the experiment. A workspace experiment is named by its absolute path in the
     workspace; a notebook experiment has the path of its notebook.
  - `artifact_location` (string, optional)
    URI of the location where the artifacts of the experiment's runs are stored. Experiments
     created without an explicit location use MLflow-managed storage under
     `dbfs:/databricks/mlflow-tracking/<experiment_id>`.
  - `lifecycle_stage` (string, optional)
    Current life cycle stage of the experiment: `active` or `deleted`. Deleted experiments are
     excluded from list and search results unless `view_type` requests them, and can be restored
     until they are permanently deleted.
  - `last_update_time` (int64, optional)
    Time when the experiment metadata was last updated, as a Unix timestamp in milliseconds.
  - `creation_time` (int64, optional)
    Time when the experiment was created, as a Unix timestamp in milliseconds.
  - `tags` (array of object, optional)
    Tags set on the experiment, as key-value pairs, including system tags such as
     `mlflow.ownerId` that MLflow maintains.
    - `key` (string, optional)
      The tag key. Keys are at most 255 characters long.
    - `value` (string, optional)
      The tag value. Values are at most 65535 characters long.
- `runs` (array of object, optional, Deprecated)
  A collection of active runs in the experiment. Note: this may not contain
   all of the experiment's active runs.
  
   This field is deprecated. Please use the "Search Runs" API to fetch
   runs within an experiment.
  - `run_id` (string, optional)
    Unique identifier for the run.
  - `run_uuid` (string, optional, Deprecated)
    [Deprecated, use run_id instead] Unique identifier for the run. This field will
     be removed in a future MLflow version.
  - `experiment_id` (string, optional)
    The experiment ID.
  - `run_name` (string, optional)
    The name of the run.
  - `user_id` (string, optional, Deprecated)
    User who initiated the run.
     This field is deprecated as of MLflow 1.0, and will be removed in a future
     MLflow release. Use 'mlflow.user' tag instead.
  - `status` (string, optional)
    Current status of the run.
    Possible values:
    - `RUNNING`
    - `SCHEDULED`
    - `FINISHED`
    - `FAILED`
    - `KILLED`
  - `start_time` (int64, optional)
    Unix timestamp of when the run started in milliseconds.
  - `end_time` (int64, optional)
    Unix timestamp of when the run ended in milliseconds.
  - `artifact_uri` (string, optional)
    URI of the directory where artifacts should be uploaded.
     This can be a local path (starting with "/"), or a distributed file system (DFS)
     path, like ``s3://bucket/directory`` or ``dbfs:/my/directory``.
     If not set, the local ``./mlruns`` directory is  chosen.
  - `lifecycle_stage` (string, optional)
    Current life cycle stage of the experiment : OneOf("active", "deleted")

## Response

```json
{
  "experiment": {
    "experiment_id": "4150739527164012",
    "name": "/Users/jane.doe@example.com/churn-prediction",
    "artifact_location": "dbfs:/Volumes/main/ml/experiment_artifacts/churn-prediction",
    "lifecycle_stage": "active",
    "last_update_time": 1762868400000,
    "creation_time": 1762004800000,
    "tags": [
      {
        "key": "team",
        "value": "growth"
      },
      {
        "key": "mlflow.note.content",
        "value": "Weekly retraining of the customer churn model."
      },
      {
        "key": "mlflow.ownerId",
        "value": "7083912345678901"
      },
      {
        "key": "mlflow.ownerEmail",
        "value": "jane.doe@example.com"
      },
      {
        "key": "mlflow.experimentType",
        "value": "MLFLOW_EXPERIMENT"
      }
    ]
  }
}
```

