Get Hyperparameters

Page Outline

• Path Parameters
• Query Parameters
• Behavior
• Response

---

Returns the hyperparameters used in a specific training run, including AutoML-selected values when algorithm: "auto" was configured.

Base Path: /api/v1/models

Method: GET

Path: /{model_id}/training-metrics/hyperparameters

Alias: /{model_id}/training/metrics/hyperparameters

Auth: Requires a valid Bearer token (Authorization: Bearer <JWT>)

Path Parameters

Parameter	Type	Description
model_id	string	Unique identifier of the model

Query Parameters

Parameter	Type	Default	Description
run_id	string	—	Specific training run ID. Defaults to the most recent completed run
version_id	string	—	Alternative: retrieve hyperparameters by version ID instead of run ID

Behavior

• For AutoML runs, includes the winner algorithm and all tested candidates with their scores.
• If run_id and version_id are both provided, version_id takes precedence.
• Returns HTTP 404 if the model, run, or version is not found.
• Alias path /training/metrics/hyperparameters is fully supported.

Response

Returns a Hyperparameters object.

{
  "model_id": "mdl-7f3a19bc",
  "run_id": "run-20260313-a4b9c2",
  "algorithm_selected": "xgboost",
  "hyperparameters": {
    "n_estimators": 200,
    "max_depth": 6,
    "learning_rate": 0.05,
    "subsample": 0.8,
    "colsample_bytree": 0.9
  },
  "automl_candidates": [
    { "algorithm": "xgboost", "score": 0.934 },
    { "algorithm": "lightgbm", "score": 0.928 },
    { "algorithm": "random_forest", "score": 0.901 }
  ]
}