MEmerchkit

Poll an async job

Status + progress of an asynchronous operation (source processing, imports, workflow runs). POST /sources returns a job_id to poll here; terminal statuses are completed, failed, and cancelled.

Scope: read:jobs.

get/jobs/{id}

Request

  • Base URL
    https://www.merchkit.com/api/v1
  • Auth
    HTTP bearer

Response

Job status.

Example response

{
  "data": {
    "id": "1f7c9a2b-6d43-4e8f-b501-a92c7d3e6f18",
    "name": "Process Source",
    "status": "running",
    "progress": {
      "current": 40,
      "total": 100,
      "percent": 40
    },
    "created_at": "2026-07-18T09:30:22Z",
    "started_at": "2026-07-18T09:30:22Z",
    "completed_at": null,
    "result": null,
    "metadata": {
      "workflow": "process-source",
      "url": "https://nordictimber.example/catalog/aria-oak-dining-table",
      "via": "api_v1"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.