---
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}`

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` string, 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

---

[API](https://skmtc.net/uhh-lt/apis/discourse-analysis-tool-suite-api.md) · [All operations](https://skmtc.net/uhh-lt/apis/discourse-analysis-tool-suite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uhh-lt/discourse-analysis-tool-suite-api/revisions/6fcf6b0bc28a/schema)