---
title: "Get job status"
method: GET
path: "/v1/eligibility/jobs/{job-id}/status"
tags: ["Jobs"]
---

# Get job status

`GET /v1/eligibility/jobs/{job-id}/status`

## Request

- Base URL: `https://api.clients.wellhub.com`
- URL: `https://api.clients.wellhub.com/v1/eligibility/jobs/{job-id}/status`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wellhub/apis/integrations-api/docs/v1/eligibility/jobs/:job-id/status/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the current status of a submitted job, including processing statistics (number of newcomers, leavers, and updaters processed).

## Path parameters

- `job-id` string, uuid, required

## Response `200`

OK. Returns the job status and statistics.

- JobStatusResponse
  - `id` string, uuid: The UUID of the job.
  - `status` 'PENDING' | 'VALIDATING' | 'SUCCEEDED' | 'SUCCEEDED_WITH_ERRORS' | 'REJECTED' | 'INTERNAL_SERVER_ERROR': Current processing status of the job. Lifecycle: `PENDING` → `VALIDATING` → `SUCCEEDED` / `SUCCEEDED_WITH_ERRORS` / `REJECTED` / `INTERNAL_SERVER_ERROR`.
  - `updated_at` string, date-time: Timestamp of the last status update.
  - `statistics` Statistics
    - `newcomers` integer: Number of employees successfully created.
    - `leavers` integer: Number of employees successfully deleted.
    - `updaters` integer: Number of employees successfully updated.

## Other responses

- `400`: Bad Request. Invalid `job-id` format.
- `401`: Unauthorized. Missing or invalid Bearer token.
- `403`: Forbidden.
- `404`: Not Found. No job found with the given ID.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/wellhub/apis/integrations-api.md) - [All operations](https://skmtc.dev/wellhub/apis/integrations-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wellhub/apis/integrations-api/revisions/3e6a46a18a2e?raw)