---
title: "Returns the COTA Refinement Job for the given ID"
method: GET
path: "/cota/refine/{cota_job_id}"
tags: ["conceptOverTimeAnalysis"]
---

# Returns the COTA Refinement Job for the given ID

`GET /cota/refine/{cota_job_id}`

## Request

- The document declares no server URL.
- Auth: OAuth 2
  - Password
  - Token URL: `/authentication/login`

Returns the COTA Refinement Job for the given ID if it exists

## Path parameters

- `cota_job_id` string, required

## Response `200`

Successful Response

- COTARefinementJobRead
  - `job_id` string, required: RQ job ID
  - `job_type` 'cota_refinement', required: Type of the job
  - `project_id` integer, required: Project ID associated with the job
  - `status` 'queued' | 'finished' | 'failed' | 'started' | 'deferred' | 'scheduled' | 'stopped' | 'canceled', required
  - `status_message` string, nullable: Status message
  - `current_step` integer, required: Current step in the job process
  - `steps` string[], required: Total number of steps in the job process
  - `input` COTARefinementJobInput, required
    - `project_id` integer, required: Project ID associated with the job
    - `cota_id` integer, required: ID of the COTA that is used in the COTARefinementJob
    - `hyperparams` COTARefinementHyperparameters
      - `cem_training_epochs` integer: Number of epochs to train the Concept Embedding Model
      - `cem_dimensions` integer: Number of dimensions of the Concept Embedding Model
  - `output` unknown
  - `created` string, date-time, required: Created timestamp of the job
  - `finished` string, date-time, nullable: Finished timestamp of the job

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-05** `3bdfd02830b1`: 1 warning, 1 info
  - added the new `cota_refinement` enum value to the `job_type` response property for the response status `200`
  - the `job_type` response property const value `cota_refinement` was added for the status `200`
- **2026-07-16** `bd1187f3520e`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2025-08-22** `53e769440a25`: 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status

[Operation history](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api/changes/cota/refine/:cota_job_id/get.md)

---

[API](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api.md) - [All operations](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api/llms.txt) - [OpenAPI document](https://skmtc.dev/uhh-lt/apis/discourse-analysis-tool-suite-api/revisions/e498207e29f4?raw)