Skip to content

Job status

Base URL https://api.accessful.de/api/v1/upload-service. Every request needs the X-API-Key header — see Authentication.

GET /job-status/{caseId}

200 OK

{ "jobStatus": "completed", "stage": "finished", "score": 87 }

score is the accessibility quality of the result, 0–100 (final once completed). 404 is returned for an unknown caseId.

The response has two independent fields: jobStatus is the coarse outcome — use it to decide when the job is done — while stage is the fine-grained pipeline phase of a running case, telling you where it currently is.

jobStatusMeaning
queuedWaiting in the queue.
runningCurrently processing.
completedFinished — result ready to download.terminal
failedProcessing failed.terminal
analyzer_failedThe accessibility analysis step failed.terminal
canceledThe job was canceled.terminal
quota_pendingAwaiting an asynchronous quota check.
quota_exceededRejected — contract quota exhausted.terminal

When polling, stop as soon as jobStatus reaches a terminal state.

stage reports the pipeline phase. jobStatus: "completed" always coincides with stage: "finished" — the point at which score is final.

stageMeaning
queuedAccepted; waiting for the first analysis.
analyzingInitial accessibility analysis is running.
resolvingAI remediation is running.
revalidatingThe remediated file is being re-analyzed; score is being recomputed.
finishedDone — score reflects the final remediated file.
failedProcessing stopped on an error.