---
title: "Get job status"
method: GET
path: "/v1/jobs/{jobId}/status"
tags: ["Jobs"]
---

# Get job status

`GET /v1/jobs/{jobId}/status`

<Note>
  Currently, this endpoint only supports schema refresh jobs. Job IDs from other job types will return an error.
</Note>

Retrieves the current status of an asynchronous job. The user authenticating the request must have **read** permissions on the connection.

This endpoint is used to check the status of jobs initiated by other API calls, such as schema refreshes. Poll this endpoint to determine when the job has completed.

## Path parameters

- `jobId` string, uuid, required

## Response `200`

Job status retrieved successfully

- object
  - `job_type` string — The type of job
  - `job_id` string, uuid — The unique identifier of the job
  - `status` 'RUNNING' | 'COMPLETED' | 'FAILED' — Current status of the job

## Other responses

- `400` — Bad Request Possible error messages: - `Bad Request: jobId: Invalid uuid`
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden Possible error messages: - `Job type not supported for status checks`
- `404` — Job not found
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

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