---
title: "✨ Get inference run info"
method: GET
path: "/api/prompts/{prompt_id}/versions/{version_id}/inference-runs"
tags: ["Prompts"]
---

# ✨ Get inference run info

`GET /api/prompts/{prompt_id}/versions/{version_id}/inference-runs`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/api/prompts/{prompt_id}/versions/{version_id}/inference-runs`
- Auth: API key in header `Authorization`

<Card href="https://humansignal.com/goenterprise">
        <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/>
        <p style="margin-top: 10px; font-size: 14px;">
            This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
        </p>
    </Card>
Get information (status, metadata, etc) about an existing inference run

## Path parameters

- `prompt_id` integer, required
- `version_id` integer, required

## Query parameters

- `ordering` string
- `parent_model` integer
- `project` integer
- `project_subset` 'All' | 'HasGT' | 'Sample'

## Response `200`

- ModelRun[]
  - `completed_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `created_by` UserSimple, required: A ModelSerializer that takes additional arguments for "fields", "omit" and "expand" in order to control which fields are displayed, and whether to replace simple values with complex, nested serializations
    - `avatar` string, nullable, required
    - `email` string, email
    - `first_name` string
    - `id` integer, required
    - `last_name` string
    - `username` string, required
  - `filters_json` unknown
  - `id` integer, required
  - `job_id` string, nullable: Job ID for inference job for a ModelRun e.g. Adala job ID
  - `model_version` integer, required
  - `organization` integer, nullable
  - `parent_model` integer, required
  - `predictions_updated_at` string, date-time, nullable
  - `project` integer, required
  - `project_subset` 'All' | 'HasGT' | 'Sample' | 'Custom': * `All` - All * `HasGT` - HasGT * `Sample` - Sample * `Custom` - Custom
  - `sample_subset_size` integer, nullable: Custom sample size for Sample subset. Uses PROMPTER_SAMPLE_SUBSET_SIZE if not set.
  - `source_model_run` integer, nullable, required
  - `status` 'Pending' | 'InProgress' | 'Completed' | 'Failed' | 'Canceled', required: * `Pending` - Pending * `InProgress` - InProgress * `Completed` - Completed * `Failed` - Failed * `Canceled` - Canceled
  - `task_ids` unknown, required
  - `total_correct_predictions` integer, nullable
  - `total_predictions` integer, nullable
  - `total_tasks` integer, nullable
  - `triggered_at` string, date-time, nullable, required

## Changes

> 142 revisions in range; 1 not diffed.

- **2026-08-07** `e1ba2ecdbabb`: 1 info
  - added the required property `items/model_version` to the response with the `200` status
- **2026-07-08** `b5f055b9d45b`: 1 breaking
  - the response property `items/created_by/allOf[#/components/schemas/UserSimple]/avatar` became nullable for the status `200`

[Operation history](https://skmtc.dev/humansignal/apis/label-studio-api/changes/api/prompts/:prompt_id/versions/:version_id/inference-runs/get.md)

---

[API](https://skmtc.dev/humansignal/apis/label-studio-api.md) - [All operations](https://skmtc.dev/humansignal/apis/label-studio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/humansignal/apis/label-studio-api/revisions/b3a81da7c74a?raw)