v1

latestOpenAPI 3.0.0Proprietary2026-08-06130577659.7 KB

Miscellaneous|Job

Request the status of a job.

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.

get/job/fetch_status

Query parameters

idinteger required

The internal id of the job. This Parameter is required.

Response

Success Response:

Example response

{
  "data": {
    "startedAt": "2015-02-20T12:59:21+01:00",
    "finishedAt": "2015-02-20T12:59:21+01:00"
  }
}