Rewards

Poll a Zama encryption job

Changed on

Returns the status of a job started by POST /v4/confidential-rewards/zama. Once status is completed, result holds the encrypted leaderboard. progress is the percentage of proofs built. A job that runs longer than 5 minutes ends as failed with a timeout in error.

The response is never cached, so every poll shows the current status. 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.

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

Request

  • Base URL: https://api.merkl.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.merkl.xyz/v4/confidential-rewards/zama/jobs/{jobId}
  • Auth: apiKey (a scheme the document does not define)

Path parameters

jobIdstring required

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

Response

Response for status 200

jobIdstring required

Unique job identifier

progressnumber

Progress percentage of the job (0-100)

resultunknown required
errorstring

Error message if job failed

createdAtnumber required

Timestamp when job was created

completedAtnumber

Timestamp when job completed

durationSecondsnumber required

Duration of the job in seconds (elapsed time if still processing, final duration if completed)

Changes