---
title: "Get prompt optimization job status and details."
method: GET
path: "/api/v2/projects/{project_id}/prompt-optimization-jobs/{job_id}"
tags: ["Prompt Optimization"]
---

# Get prompt optimization job status and details.

`GET /api/v2/projects/{project_id}/prompt-optimization-jobs/{job_id}`

Returns the current status of the prompt optimization job, including progress information
for polling. When complete, includes the optimized_version_id and optionally
test_run_id and comparison_id if run_test_after_optimization was True.

## Path parameters

- `project_id` string, required
- `job_id` string, required

## Response `200`

PromptOptimizationJobStatusResponse(job_id: uuid.UUID, status: str, prompt_template_id: uuid.UUID, original_version_id: uuid.UUID, run_test_after_optimization: bool, created_at: datetime.datetime, optimized_version_id: Optional[uuid.UUID] = None, test_run_id: Optional[uuid.UUID] = None, comparison_id: Optional[uuid.UUID] = None, changes_summary: Optional[str] = None, error_message: Optional[str] = None, data_sources_used: Optional[server.api_routes.prompt_optimization_jobs_api_v2.DataSourcesUsed] = None, completed_at: Optional[datetime.datetime] = None, progress: Optional[server.api_routes.prompt_optimization_jobs_api_v2.JobProgress] = None)

- object
  - `job_id` string, uuid, required
  - `status` string, required
  - `prompt_template_id` string, uuid, required
  - `original_version_id` string, uuid, required
  - `run_test_after_optimization` boolean, required
  - `created_at` string, date-time, required
  - `optimized_version_id` string, uuid, nullable
  - `test_run_id` string, uuid, nullable
  - `comparison_id` string, uuid, nullable
  - `changes_summary` string, nullable
  - `error_message` string, nullable
  - `data_sources_used` DataSourcesUsed
    - `human_labels_count` integer, required
    - `customer_feedback_count` integer, required
  - `completed_at` string, date-time, nullable
  - `progress` JobProgress
    - `step` integer, required
    - `total_steps` integer, required
    - `step_name` string, required

---

[API](https://skmtc.net/freeplay/apis/freeplay-api.md) · [All operations](https://skmtc.net/freeplay/apis/freeplay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freeplay/freeplay-api/revisions/69c553220183/schema)