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

# List job errors

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

## Request

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

Returns a paginated list of processing errors for the specified job. Use this after a job has been submitted to identify records that failed processing.

> **ℹ️ When to call this.** Errors are populated for jobs in `SUCCEEDED_WITH_ERRORS` or `REJECTED` terminal status. Calling this endpoint for jobs in other statuses will return an empty list.

## Path parameters

- `job-id` string, uuid, required

## Query parameters

- `cursor` string

## Response `200`

OK. Returns a paginated list of job errors.

- JobErrorsResponse
  - `data` JobError[]
    - `change_number` integer, nullable: The sequence number of the job item that caused the error.
    - `company_tax_id` string, nullable: Tax ID of the company associated with the failed item. Useful for tracing which company an error belongs to when a job spans multiple companies.
    - `error_type` string: Type/code of the error that occurred.
    - `field_name` string, nullable: Name of the field that caused the error, if applicable.
    - `field_value` string, nullable: Value of the field that caused the error, if applicable.
    - `recovered_by` string, nullable: Identifier of the process or user that recovered this error, if applicable.
  - `cursor` string, nullable: Cursor for the next page. `null` if no more results.

## Other responses

- `400`: Bad Request. Invalid `job-id` format.
- `401`: Unauthorized. Missing or invalid Bearer token.
- `403`: Forbidden.
- `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)