---
title: "Get prediction jobs with given id"
method: GET
path: "/models/{model_id}/versions/{version_id}/jobs/{job_id}"
tags: ["prediction_jobs"]
---

# Get prediction jobs with given id

`GET /models/{model_id}/versions/{version_id}/jobs/{job_id}`

## Request

- Base URL: `http://localhost:8080/v1`
- URL: `http://localhost:8080/v1/models/{model_id}/versions/{version_id}/jobs/{job_id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/caraml-dev/apis/merlin/docs/models/:model_id/versions/:version_id/jobs/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `model_id` integer, required
- `version_id` integer, required
- `job_id` integer, required

## Response `200`

OK

- PredictionJob
  - `id` integer
  - `name` string
  - `version_id` integer
  - `model_id` integer
  - `project_id` integer
  - `environment_name` string
  - `environment` Environment
    - `id` integer
    - `name` string, required
    - `cluster` string, required
    - `is_default` boolean
    - `region` string
    - `gcp_project` string
    - `default_resource_request` ResourceRequest
      - `min_replica` integer
      - `max_replica` integer
      - `cpu_request` string
      - `cpu_limit` string
      - `memory_request` string
      - `gpu_name` string
      - `gpu_request` string
      - `liveness_probe` ProbeConfig
        - `path` string: Path for HTTP probe
        - `port` integer: Port for the probe
        - `scheme` string: Scheme for HTTP probe (HTTP or HTTPS)
        - `initial_delay_seconds` integer: Initial delay before starting the probe (seconds)
        - `timeout_seconds` integer: Timeout for the probe (seconds)
        - `period_seconds` integer: Period between probe checks (seconds)
        - `success_threshold` integer: Number of successes required to be considered healthy
        - `failure_threshold` integer: Number of failures before considered unhealthy
      - `readiness_probe` ProbeConfig
        - `path` string: Path for HTTP probe
        - `port` integer: Port for the probe
        - `scheme` string: Scheme for HTTP probe (HTTP or HTTPS)
        - `initial_delay_seconds` integer: Initial delay before starting the probe (seconds)
        - `timeout_seconds` integer: Timeout for the probe (seconds)
        - `period_seconds` integer: Period between probe checks (seconds)
        - `success_threshold` integer: Number of successes required to be considered healthy
        - `failure_threshold` integer: Number of failures before considered unhealthy
    - `default_transformer_resource_request` ResourceRequest
      - `min_replica` integer
      - `max_replica` integer
      - `cpu_request` string
      - `cpu_limit` string
      - `memory_request` string
      - `gpu_name` string
      - `gpu_request` string
      - `liveness_probe` ProbeConfig
        - `path` string: Path for HTTP probe
        - `port` integer: Port for the probe
        - `scheme` string: Scheme for HTTP probe (HTTP or HTTPS)
        - `initial_delay_seconds` integer: Initial delay before starting the probe (seconds)
        - `timeout_seconds` integer: Timeout for the probe (seconds)
        - `period_seconds` integer: Period between probe checks (seconds)
        - `success_threshold` integer: Number of successes required to be considered healthy
        - `failure_threshold` integer: Number of failures before considered unhealthy
      - `readiness_probe` ProbeConfig
        - `path` string: Path for HTTP probe
        - `port` integer: Port for the probe
        - `scheme` string: Scheme for HTTP probe (HTTP or HTTPS)
        - `initial_delay_seconds` integer: Initial delay before starting the probe (seconds)
        - `timeout_seconds` integer: Timeout for the probe (seconds)
        - `period_seconds` integer: Period between probe checks (seconds)
        - `success_threshold` integer: Number of successes required to be considered healthy
        - `failure_threshold` integer: Number of failures before considered unhealthy
    - `default_prediction_job_resource_request` PredictionJobResourceRequest
      - `driver_cpu_request` string
      - `driver_memory_request` string
      - `executor_cpu_request` string
      - `executor_memory_request` string
      - `executor_replica` integer
    - `gpus` GPUConfig[]
      - `name` string
      - `values` string[]
      - `resource_type` string
      - `node_selector` object
      - `tolerations` GPUToleration[]
        - `key` string
        - `operator` string
        - `value` string
        - `effect` string
        - `toleration_seconds` integer
      - `min_monthly_cost_per_gpu` number
      - `max_monthly_cost_per_gpu` number
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `config` Config
    - `job_config` PredictionJobConfig
      - `version` string
      - `kind` string
      - `name` string
      - `bigquery_source` object
        - `table` string
        - `features` string[]
        - `options` object
      - `gcs_source` object
        - `format` 'INVALID_FILE_FORMAT' | 'CSV' | 'PARQUET' | 'AVRO' | 'JSON'
        - `uri` string
        - `features` string[]
        - `options` object
      - `maxcompute_source` object
        - `endpoint` string
        - `table` string
        - `features` string[]
        - `options` object
      - `model` object
        - `type` 'INVALID_MODEL_TYPE' | 'XGBOOST' | 'TENSORFLOW' | 'SKLEARN' | 'PYTORCH' | 'ONNX' | 'PYFUNC' | 'PYFUNC_V2' | 'CUSTOM'
        - `uri` string
        - `result` object
          - `type` 'DOUBLE' | 'FLOAT' | 'INTEGER' | 'LONG' | 'STRING' | 'ARRAY'
          - `item_type` 'DOUBLE' | 'FLOAT' | 'INTEGER' | 'LONG' | 'STRING' | 'ARRAY'
        - `options` object
      - `bigquery_sink` object
        - `table` string
        - `staging_bucket` string
        - `result_column` string
        - `save_mode` 0 | 1 | 2 | 3 | 4
        - `options` object
      - `gcs_sink` object
        - `format` 'INVALID_FILE_FORMAT' | 'CSV' | 'PARQUET' | 'AVRO' | 'JSON'
        - `uri` string
        - `result_column` string
        - `save_mode` 0 | 1 | 2 | 3 | 4
        - `options` object
      - `maxcompute_sink` object
        - `endpoint` string
        - `table` string
        - `result_column` string
        - `save_mode` 0 | 1 | 2 | 3 | 4
        - `options` object
    - `image_ref` string
    - `service_account_name` string
    - `resource_request` PredictionJobResourceRequest
      - `driver_cpu_request` string
      - `driver_memory_request` string
      - `executor_cpu_request` string
      - `executor_memory_request` string
      - `executor_replica` integer
    - `image_builder_resource_request` ResourceRequest
      - `min_replica` integer
      - `max_replica` integer
      - `cpu_request` string
      - `cpu_limit` string
      - `memory_request` string
      - `gpu_name` string
      - `gpu_request` string
      - `liveness_probe` ProbeConfig
        - `path` string: Path for HTTP probe
        - `port` integer: Port for the probe
        - `scheme` string: Scheme for HTTP probe (HTTP or HTTPS)
        - `initial_delay_seconds` integer: Initial delay before starting the probe (seconds)
        - `timeout_seconds` integer: Timeout for the probe (seconds)
        - `period_seconds` integer: Period between probe checks (seconds)
        - `success_threshold` integer: Number of successes required to be considered healthy
        - `failure_threshold` integer: Number of failures before considered unhealthy
      - `readiness_probe` ProbeConfig
        - `path` string: Path for HTTP probe
        - `port` integer: Port for the probe
        - `scheme` string: Scheme for HTTP probe (HTTP or HTTPS)
        - `initial_delay_seconds` integer: Initial delay before starting the probe (seconds)
        - `timeout_seconds` integer: Timeout for the probe (seconds)
        - `period_seconds` integer: Period between probe checks (seconds)
        - `success_threshold` integer: Number of successes required to be considered healthy
        - `failure_threshold` integer: Number of failures before considered unhealthy
    - `env_vars` EnvVar[]
      - `name` string
      - `value` string
    - `secrets` MountedMLPSecret[]
      - `mlp_secret_name` string, required
      - `env_var_name` string, required
  - `status` string
  - `error` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `404`: Prediction job with given ID is not found

## Changes

> 34 revisions in range; 4 not diffed.

- **2026-07-17** `a1e12cbeeebc`: 6 info
  - added the optional property `config/image_builder_resource_request/liveness_probe` to the response with the `200` status
  - added the optional property `config/image_builder_resource_request/readiness_probe` to the response with the `200` status
  - added the optional property `environment/default_resource_request/liveness_probe` to the response with the `200` status
  - added the optional property `environment/default_resource_request/readiness_probe` to the response with the `200` status
  - …2 more
- **2024-01-23** `c3ef0b1c733b`: 1 info
  - added the media type `*/*` for the response with the status `200`
- **2023-12-05** `d062ab20ef25`: 1 breaking
  - removed the media type `*/*` for the response with the status `200`
- **2020-09-28** `c4b3505de7df`: 1 breaking
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/caraml-dev/apis/merlin/changes/models/:model_id/versions/:version_id/jobs/:job_id/get.md)

---

[API](https://skmtc.dev/caraml-dev/apis/merlin.md) - [All operations](https://skmtc.dev/caraml-dev/apis/merlin/llms.txt) - [OpenAPI document](https://skmtc.dev/caraml-dev/apis/merlin/revisions/a1e12cbeeebc?raw)
