---
title: "Get a job"
method: GET
path: "/workspaces/{workspace_id}/jobs/{job_id}"
tags: ["Jobs"]
---

# Get a job

`GET /workspaces/{workspace_id}/jobs/{job_id}`

## Request

- Base URL: `https://api.compelling.ai/v1`
- URL: `https://api.compelling.ai/v1/workspaces/{workspace_id}/jobs/{job_id}`
- Auth: HTTP bearer

Poll this endpoint to check the status of an async operation.

## Response `200`

OK

- Job
  - `job_id` string
  - `status` 'pending' | 'running' | 'complete' | 'failed'
  - `type` 'contact_generation' | 'account_insight_answers' | 'contact_insight_answers' | 'workflow_run'
  - `list_id` string
  - `error` string, nullable: Error message if status is `failed`.
  - `result` object, nullable: Summary or result data when status is `complete`.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `404`: Resource not found

---

[API](https://skmtc.dev/compelling/apis/compelling-api.md) · [All operations](https://skmtc.dev/compelling/apis/compelling-api/llms.txt) · [OpenAPI document](https://skmtc.dev/compelling/apis/compelling-api/revisions/55049ff28c67?raw)