---
title: "Request the status of a job."
method: GET
path: "/job/fetch_status"
tags: ["Miscellaneous|Job"]
---

# Request the status of a job.

`GET /job/fetch_status`

This endpoint allows you to retrieve the status of a background job within geoCapture. Jobs are used for
calculations or tasks that may last several minutes. When the job status is set to `WAITING`, it will be placed
into the queue for execution. When the status is set to `RUNNING` the job is currently being executed. After
execution, the status will be set to `SUCCESS` if no errors occurred.

An example of an endpoint that returns a job id is the import bill of quantities endpoint or the calculate
tour endpoint. In the `returnValue` field, the job's individual return value is provided.

## Query parameters

- `id` integer, required

## Response `200`

Success Response:

- StandardJobFetchStatusResponse
  - `data` JobFetchStatusRequestJobItem
    - `status` string — The Job status. | Value | Description | |-------------------|-----------------------------------------------------------------------| | WAITING | The job is waiting in the queue and is not started yet. | | STARTING | The job is getting started by the jobmanager but not running yet. | | RUNNING | The job is currently running. | | SUCCESS | The job is succesfully finished. | | ERROR | The job exited with an error. |
    - `returnValue` integer[] — The return value of the job.
    - `progress` number — The progress of the job.
    - `startedAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `finishedAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/869b05603541/schema)