---
title: "Poll a Zama encryption job"
method: GET
path: "/v4/confidential-rewards/zama/jobs/{jobId}"
tags: ["Rewards"]
---

# Poll a Zama encryption job

`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)

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.

## Path parameters

- `jobId` string, required: Job ID returned by `POST /v4/confidential-rewards/zama`

## Response `200`

Response for status 200

- object
  - `jobId` string, required: Unique job identifier
  - `status` union, required
    - string
    - string
    - string
    - string
  - `progress` number: Progress percentage of the job (0-100)
  - `result` unknown, required
  - `error` string: Error message if job failed
  - `createdAt` number, required: Timestamp when job was created
  - `completedAt` number: Timestamp when job completed
  - `durationSeconds` number, required: Duration of the job in seconds (elapsed time if still processing, final duration if completed)

## Changes

- **2026-10-09** `c8b105eb3f1d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/merkl/apis/merkl-api/changes/v4/confidential-rewards/zama/jobs/:jobId/get.md)

---

[API](https://skmtc.dev/merkl/apis/merkl-api.md) - [All operations](https://skmtc.dev/merkl/apis/merkl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/merkl/apis/merkl-api/revisions/60ffe2c7d887?raw)