---
title: "Get a job"
description: "Read one job. When the job is completed the envelope carries its result; when it failed it carries the error."
url: https://docs.roasos.com/api-reference/jobs/getJob
---

# Get a job

Read one job. When the job is completed the envelope carries its result; when it failed it carries the error.

## `GET /v1/jobs/{id}`

Endpoint: `GET https://api.roasos.com/v1/jobs/{id}`

Get a job

Read one job. When the job is completed the envelope carries its result; when it failed it carries the error.

### Parameters

- `id` (path) — required

### Responses

- `200`: Job envelope
- `400`: The job ID is not a UUID
- `404`: Job not found in this workspace

Read the full reference at https://docs.roasos.com/api-reference/jobs/getJob.