---
title: "Progress of a public factor's reclassification"
method: GET
path: "/factor/utility-reclassify-jobs/{jobId}"
tags: ["Factor Manage"]
---

# Progress of a public factor's reclassification

`GET /factor/utility-reclassify-jobs/{jobId}`

The background job a public factor's mapping change queued: its status and how many organizations and rows are done. Only Greentally platform staff holding the factor_library.write platform capability may read it (403 PLATFORM_CAPABILITY_REQUIRED otherwise). Reading an unfinished job also resumes it in this instance when no runner holds it.

## Path parameters

- `jobId` string, required

## Response `200`

The job.

- UtilityReclassifyJobResponse
  - `data` UtilityReclassifyJob, required
    - `attempts` integer, required — Times a runner picked the job up.
    - `createdAt` string, date-time, required
    - `createdBy` string, required
    - `factorEntryId` string, required
    - `finishedAt` string, date-time, nullable, required
    - `id` string, uuid, required
    - `lastError` string, nullable, required
    - `orgsDone` integer, required
    - `orgsFailed` integer, required
    - `orgsTotal` integer, required
    - `rowsEstimate` integer, required — Rows using the factor when the job was queued.
    - `rowsReclassified` integer, required — Rows reclassified so far.
    - `rowsReset` integer, required — Rows cleared for reclassification so far (rows using the factor and the non-carbon rows of their documents).
    - `status` 'queued' | 'running' | 'done' | 'failed', required — failed when an organization still failed after its retries (lastError says which).
    - `updatedAt` string, date-time, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-10-02** `766c2a40e369` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greentally/apis/esgai-api/changes/factor/utility-reclassify-jobs/:jobId/get.md)

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/greentally/apis/esgai-api/revisions/5c524454c847?raw)