---
title: "Return the status of an asynchronous Job"
method: GET
path: "/v1/jobs/{uuid}"
tags: ["jobs"]
---

# Return the status of an asynchronous Job

`GET /v1/jobs/{uuid}`

## Path parameters

- `uuid` string, uuid, required

## Response `200`

Returns the status of a job if it is still running or has failed

- object
  - `data` JobRead, required
    - `status` 'Running' | 'Finished' | 'Failed', required — Current status of the job
    - `reason` string — Human-readable error message when job has failed
    - `_links` JobReadLinks
      - `results` HalLink, required
        - `href` string, uri, required
        - `title` string — A human-readable title for the link
        - `type` string, required — The content-type
      - `fieldguide` HalLink
        - `href` string, uri, required
        - `title` string — A human-readable title for the link
        - `type` string, required — The content-type

## Other responses

- `302` — Returns the status of a job if it has finished and redirects to the appropriate endpoint to get the result resource
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found

---

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