--- title: "List all prediction jobs of a model version with pagination" method: GET path: "/models/{model_id}/versions/{version_id}/jobs-by-page" tags: ["prediction_jobs"] --- # List all prediction jobs of a model version with pagination `GET /models/{model_id}/versions/{version_id}/jobs-by-page` ## Request - Base URL: `http://localhost:8080/v1` - URL: `http://localhost:8080/v1/models/{model_id}/versions/{version_id}/jobs-by-page` - Auth: API key in header `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `model_id` integer, required - `version_id` integer, required ## Query parameters - `page` integer - `page_size` integer - `search` string ## Response `200` OK - ListJobsPaginatedResponse - `results` PredictionJob[], required - `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 - `paging` Paging, required - `total` integer, required: Total number of results matching the query criteria - `page` integer, required: Number of the current page - `pages` integer, required: Total number of pages ## Other responses - `404`: Page not found ## Changes > 34 revisions in range; 4 not diffed. - **2026-07-17** `a1e12cbeeebc`: 6 info - added the optional property `results/items/config/image_builder_resource_request/liveness_probe` to the response with the `200` status - added the optional property `results/items/config/image_builder_resource_request/readiness_probe` to the response with the `200` status - added the optional property `results/items/environment/default_resource_request/liveness_probe` to the response with the `200` status - added the optional property `results/items/environment/default_resource_request/readiness_probe` to the response with the `200` status - …2 more - **2024-05-21** `067fa53a0aee`: 1 info - endpoint added - **2023-12-05** `d062ab20ef25`: 1 breaking - api path removed without deprecation - **2020-09-28** `c4b3505de7df`: 1 breaking - api path removed without deprecation [Operation history](https://skmtc.dev/caraml-dev/apis/merlin/changes/models/:model_id/versions/:version_id/jobs-by-page/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)