---
title: "GET /api/v1/public/recommendations/{snapshotId}"
method: GET
path: "/api/v1/public/recommendations/{snapshotId}"
tags: ["Public Recommendations"]
---

# GET /api/v1/public/recommendations/{snapshotId}

`GET /api/v1/public/recommendations/{snapshotId}`

Get recommendations status for a snapshot

## Path parameters

- `snapshotId` string, uuid, required

## Response `200`

Recommendations status

- GetRecommendationsResponse
  - `snapshot_id` string, uuid, required
  - `status` 'processing' | 'completed' | 'failed', required
  - `recommended_models` object[], nullable, required
    - `base_model_id` string, required
    - `recommended` boolean, required
    - `full_hyperparameters` object, nullable, required
      - `n_epochs` integer, required
      - `batch_size` integer, required
      - `learning_rate_multiplier` number, required
    - `lora_hyperparameters` object, nullable, required
      - `n_epochs` integer, required
      - `batch_size` integer, required
      - `learning_rate_multiplier` number, required
    - `reason_for_recommendation` string, nullable, required
  - `recommended_experiments` object[], nullable, required
    - `base_model_id` string, required
    - `batch_size` integer, required
    - `learning_rate_multiplier` number, required
    - `n_epochs` integer, required
    - `training_type` 'full' | 'lora' | 'qlora', required
    - `recommended` boolean, required
    - `reason_for_recommendation` string, nullable, required

## Other responses

- `404` — Snapshot not found
- `500` — Internal server error

## Changes

- **2025-12-12** `2cb1f5df1b89` — 1 breaking, 1 info
  - removed the required property `recommended_experiments/items/lora` from the response with the `200` status
  - added the required property `recommended_experiments/items/training_type` to the response with the `200` status
- **2025-11-12** `d71329d1d771` — 10 breaking, 9 info
  - the response property `recommended_models/items/full_hyperparameters` became nullable for the status `200`
  - the response property `recommended_models/items/lora_hyperparameters` became nullable for the status `200`
  - removed the required property `recommended_models/items/baseModelId` from the response with the `200` status
  - removed the required property `recommended_models/items/full_hyperparameters/batchSize` from the response with the `200` status
  - …15 more
- **2025-11-12** `25d63a01824a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/premai-io/apis/prem-studio-api/changes/api/v1/public/recommendations/:snapshotId/get.md)

---

[API](https://skmtc.dev/premai-io/apis/prem-studio-api.md) · [All operations](https://skmtc.dev/premai-io/apis/prem-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/premai-io/prem-studio-api/revisions/2cb1f5df1b89/schema)