---
title: "retrieve the status of a job"
method: GET
path: "/jobs/{jobId}"
tags: ["Processes"]
---

# retrieve the status of a job

`GET /jobs/{jobId}`

## Request

- Base URL: `http://example.org/ogcapi`
- URL: `http://example.org/ogcapi/jobs/{jobId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/bbox-services/apis/ogc-api-processes-part-1-core/docs/jobs/:jobId/get.ts> (a function with typed inputs; its response is checked against the schema)

Shows the status of a job.

 For more information, see [Section 7.12](https://docs.ogc.org/is/18-062/18-062.html#sc_retrieve_status_info).

## Path parameters

- `jobId` string, required

## Response `200`

The status of a job.

- StatusInfo
  - `processID` string
  - `type` 'process', required
  - `jobID` string, required
  - `status` 'accepted' | 'running' | 'successful' | 'failed' | 'dismissed', required
  - `message` string
  - `created` string, date-time
  - `started` string, date-time
  - `finished` string, date-time
  - `updated` string, date-time
  - `progress` integer
  - `links` Link[]
    - `href` string, required
    - `rel` string
    - `type` string
    - `hreflang` string
    - `title` string

## Other responses

- `404`: The requested URI was not found.
- `500`: A server error occurred.

## Changes

- **2023-03-08** `6a59a205bb9c`: 2 info
  - api tag `Processes` added
  - api tag `Status` removed
- **2022-06-26** `a31400203d45`: 1 breaking, 5 info
  - added the new path request parameter `jobId`
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `404`
  - added the media type `application/json` for the response with the status `500`
  - …2 more
- **2022-06-24** `6e199f8a91c5`: 5 breaking, 1 warning, 2 info
  - removed the media type `application/json` for the response with the status `200`
  - removed the media type `application/json` for the response with the status `404`
  - removed the media type `application/json` for the response with the status `500`
  - removed the media type `text/html` for the response with the status `404`
  - …4 more

[Operation history](https://skmtc.dev/bbox-services/apis/ogc-api-processes-part-1-core/changes/jobs/:jobId/get.md)

---

[API](https://skmtc.dev/bbox-services/apis/ogc-api-processes-part-1-core.md) - [All operations](https://skmtc.dev/bbox-services/apis/ogc-api-processes-part-1-core/llms.txt) - [OpenAPI document](https://skmtc.dev/bbox-services/apis/ogc-api-processes-part-1-core/revisions/52e9186345cc?raw)