Merkl Developer Portal logo
get

/v4/confidential-rewards/zama/jobs/{jobId}

Poll a Zama encryption job

Returns the status of a job started by POST /v4/confidential-rewards/zama. Once status is
completed, result holds the encrypted leaderboard. progress is not reported.

A failed job reports its cause in error (for example an amount that overflows the FHE type).
State lives in Redis for 30 minutes, so an unknown or expired job ID answers 404 — start a new job.
The access gate is applied again on the finished result.

Path parameters

jobIdstring
required

Job ID returned by POST /v4/confidential-rewards/zama

Responses

200
Response for status 200
Schema
object
jobIdstring
required
Unique job identifier
statusenum
required
pendingprocessingcompletedfailed
progressnumberProgress percentage of the job (0-100)
resultany
required
Result of the job if completed
errorstringError message if job failed
createdAtnumber
required
Timestamp when job was created
completedAtnumberTimestamp when job completed
durationSecondsnumber
required
Duration of the job in seconds (elapsed time if still processing, final duration if completed)
Example
{
  "jobId": "string",
  "status": "pending",
  "progress": 0,
  "result": null,
  "error": "string",
  "createdAt": 0,
  "completedAt": 0,
  "durationSeconds": 0
}