MEmerchkit

List recent jobs

Asynchronous jobs for this workspace, newest first.

Scope: read:jobs.

get/jobs

Request

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

Query parameters

limitinteger

Rows per page, 1 to 200. Defaults to 50.

Larger pages mean fewer round-trips. 200 is also the cap on in operator value lists, so refetching a full page of IDs with filter[id][in]=... always fits in one call.

offsetinteger

Rows to skip. Zero-based. Echoed back in pagination.offset.

Page forward by adding limit each time. Stop when pagination.has_more is false rather than comparing counts. Default order is created_at ascending, which keeps long sweeps stable: new rows land at the end instead of shifting pages you have not read yet.

Response

A page of jobs.

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"
      }
    }
  ],
  "pagination": {
    "total": 128,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

Changes

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