---
title: "Poll a reallocation walk job (BETA)"
method: GET
path: "/v4/reallocations/jobs/{jobId}"
tags: ["Reallocations"]
---

# Poll a reallocation walk job (BETA)

`GET /v4/reallocations/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/reallocations/jobs/{jobId}`
- Auth: `apiKey` (a scheme the document does not define)

**Poll a Reallocation Walk**
<p>Returns the status of a walk started by <code>POST /v4/reallocations/report/{campaignId}/walk</code>. <code>progress</code> is a percentage of the waves attributed; once <code>status</code> is <code>completed</code>, <code>result</code> holds the report. Check <code>result.walk.complete</code> before trusting per-sender amounts.</p>
<p>State lives in Redis for 30 minutes and is not persisted, so an unknown or expired job ID answers 404 — start a new walk. Any pod can serve the poll, not just the one running the walk.</p>
<p><strong>Authentication:</strong> Requires either a valid <code>x-api-key</code> header or the back-office bearer secret.</p>
<p>⚠️ <strong>Beta:</strong> this endpoint is in beta. The behavior, response shape and data format may change at any time without notice.</p>

## Path parameters

- `jobId` string, required: Job ID returned by `POST /v4/reallocations/report/:campaignId/walk`

## 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-09-09** `020dd1a3d27d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/merkl/apis/merkl-api/changes/v4/reallocations/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)