Jobs

Get job status

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

get/v1/eligibility/jobs/{job-id}/status

Request

Path parameters

job-idstring uuid required

The UUID of the job.

Response

OK. Returns the job status and statistics.

idstring 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_atstring date-time

Timestamp of the last status update.

Example response

{
  "status": "SUCCEEDED",
  "statistics": {
    "newcomers": 10,
    "leavers": 2,
    "updaters": 5
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.