---
title: "Get Latest Results"
method: POST
path: "/gnimbus/get_latest_results"
---

# Get Latest Results

`POST /gnimbus/get_latest_results`

Get the latest results from group iteration.

Args:
    request (GroupInfoRequest): essentially just the ID of the group
    user (Annotated[User, Depends(get_current_user)]): Current user
    session (Annotated[Session, Depends(get_session)]): Database session.

Returns:
    GNIMBUSResultResponse: A GNIMBUSResultResponse response containing the latest gnimbus results

Raises:
    HTTPException: Validation errors or no results

## Request body

- GroupInfoRequest — Class for requesting group information.
  - `group_id` integer, required

## Response `200`

Successful Response

- GNIMBUSResultResponse — The response for getting GNIMBUS results.
  - `method` string, required
  - `phase` string, required
  - `preferences` union, required
    - VotingPreference — Voting preferences.
      - `method` string
      - `set_preferences` object, required
    - OptimizationPreference — An optimization preference class. As for the method and phase, see GNIMBUS for details.
      - `method` string
      - `phase` string
      - `set_preferences` object, required
  - `common_results` SolutionReference[], required
    - `name` string, nullable — Optional name to help identify the solution if, e.g., saved.
    - `solution_index` integer, nullable — The index of the referenced solution, if multiple solutions exist in the reference state.
    - `state` StateDB, required — State holder with a single relationship to the base State.
      - `id` integer, nullable
      - `problem_id` integer, nullable
      - `session_id` integer, nullable
      - `parent_id` integer, nullable
      - `state_id` integer, nullable
    - `objective_values_all` object[], required
    - `variable_values_all` object[], required
    - `objective_values` object, nullable, required
    - `variable_values` object, nullable, required
    - `state_id` integer, required
    - `num_solutions` integer, required
  - `user_results` SolutionReference[], required
    - `name` string, nullable — Optional name to help identify the solution if, e.g., saved.
    - `solution_index` integer, nullable — The index of the referenced solution, if multiple solutions exist in the reference state.
    - `state` StateDB, required — State holder with a single relationship to the base State.
      - `id` integer, nullable
      - `problem_id` integer, nullable
      - `session_id` integer, nullable
      - `parent_id` integer, nullable
      - `state_id` integer, nullable
    - `objective_values_all` object[], required
    - `variable_values_all` object[], required
    - `objective_values` object, nullable, required
    - `variable_values` object, nullable, required
    - `state_id` integer, required
    - `num_solutions` integer, required
  - `personal_result_index` integer, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/industrial-optimization-group/apis/desdeo-fast-api.md) · [All operations](https://skmtc.net/industrial-optimization-group/apis/desdeo-fast-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/industrial-optimization-group/desdeo-fast-api/versions/c24fa4e23380/schema)