Get backfill status

curl \
  'https://api.gowindmill.com/api/v2/c/acme/cycles/backfills/019f4a10-3c2e-7a91-b6d4-1f0a2c9e8b77' \
  -H 'Authorization: Bearer wm_api_xxxxxxxxxxxxxxxxxxxx'

{
  "jobId": "019f4a10-3c2e-7a91-b6d4-1f0a2c9e8b77",
  "status": "COMPLETED",
  "cycleId": "019f4a10-3c2d-7f42-a8c1-9b6e5d3a2f10",
  "steps": [
    {
      "step": "cycle",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:04.000Z",
      "completedAt": "2026-07-21T17:02:06.000Z",
      "detail": null
    },
    {
      "step": "stage:SELF",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:06.000Z",
      "completedAt": "2026-07-21T17:02:08.000Z",
      "detail": null
    },
    {
      "step": "stage:MANAGER",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:08.000Z",
      "completedAt": "2026-07-21T17:02:11.000Z",
      "detail": null
    },
    {
      "step": "releases",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:11.000Z",
      "completedAt": "2026-07-21T17:02:12.000Z",
      "detail": null
    },
    {
      "step": "complete",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:12.000Z",
      "completedAt": "2026-07-21T17:02:12.000Z",
      "detail": null
    }
  ],
  "error": null,
  "completedAt": "2026-07-21T17:02:12.000Z"
}

{
  "jobId": "019f4a10-3c2e-7a91-b6d4-1f0a2c9e8b77",
  "status": "IMPORTING",
  "cycleId": "019f4a10-3c2d-7f42-a8c1-9b6e5d3a2f10",
  "steps": [
    {
      "step": "cycle",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:04.000Z",
      "completedAt": "2026-07-21T17:02:06.000Z",
      "detail": null
    },
    {
      "step": "stage:SELF",
      "status": "RUNNING",
      "startedAt": "2026-07-21T17:02:06.000Z",
      "completedAt": null,
      "detail": null
    }
  ],
  "error": null,
  "completedAt": null
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Backfill job not found",
    "requestId": "019f2986-8ea9-79ff-8ac2-612072b7cca6"
  }
}

Returns the current status and step-by-step history of a backfill import job started with Create a backfill. Poll it with the jobId from that call until the job reports COMPLETED or FAILED.

GET /api/v2/c/{companySlug}/cycles/backfills/{jobId}

Imports usually finish quickly, but the work is asynchronous. A 201 from the create call means that the payload passed validation. Windmill queues new and VALIDATED jobs. An idempotent replay of an IMPORTING, COMPLETED, or FAILED job returns the original IDs but does not queue the job again. Once the job reports COMPLETED, the imported cycle is fully materialized and you can read it back with Export cycle packets.

Authorization

This endpoint enforces one rule beyond a valid API key:

Admins and HR Admins only. The member who created the API key must hold the performance_reviews.manage_cycles capability, which the Admin and HR Admin roles grant. A valid key without the capability returns 403 Forbidden.

Path parameters

string

required

Your company’s slug. Find it in your Dashboard URL, right after /s/:https://app.gowindmill.com/s/{companySlug}/home

string

required

The import job’s id, returned as jobId by Create a backfill.

Response

string

required

The import job’s id.

string

required

The job’s overall status:

VALIDATED — the payload passed validation and the import has not started. This status does not confirm that queueing succeeded.
IMPORTING — the import is running; steps shows how far it has gotten.
COMPLETED — the cycle imported successfully. Terminal.
FAILED — the import stopped with an error; see error and the failed step’s detail. Terminal. To re-run, submit a new create call with a different idempotencyKey.

string | null

required

The id of the cycle this job is importing — the same cycleId the create call returned.

object[]

required

Step history in chronological order. Steps appear as the import reaches them, so a queued job can have an empty list. Step names include cycle (the cycle shell, reviewees, and questions), one stage:{type} entry per imported stage (for example stage:SELF, stage:MANAGER), calibration and releases when the payload included them, and complete.

Show step properties

string

required

The step’s name, for example cycle or stage:MANAGER.

string

required

The step’s status: PENDING, RUNNING, COMPLETED, or FAILED.

string | null

required

ISO-8601 time the step started; null if it hasn’t.

string | null

required

ISO-8601 time the step finished (successfully or not); null while pending or running.

object | null

required

Step-specific detail, such as counts of imported records or failure context; null when there’s none.

object | null

required

Failure information when status is FAILED; null otherwise.

string | null

required

ISO-8601 time the job reached a terminal status (COMPLETED or FAILED); null while it’s still queued or running.

Errors

Status	When
`401 Unauthorized`	The API key is missing, malformed, expired, or revoked.
`403 Forbidden`	The key is valid but its creator doesn’t hold the `performance_reviews.manage_cycles` capability (Admin or HR Admin role).
`404 Not Found`	No import job with this `jobId` exists in your company, or the job isn’t a performance-review backfill.

The error response body is always shaped like this:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Backfill job not found",
    "requestId": "019f2986-8ea9-79ff-8ac2-612072b7cca6"
  }
}

curl \
  'https://api.gowindmill.com/api/v2/c/acme/cycles/backfills/019f4a10-3c2e-7a91-b6d4-1f0a2c9e8b77' \
  -H 'Authorization: Bearer wm_api_xxxxxxxxxxxxxxxxxxxx'

{
  "jobId": "019f4a10-3c2e-7a91-b6d4-1f0a2c9e8b77",
  "status": "COMPLETED",
  "cycleId": "019f4a10-3c2d-7f42-a8c1-9b6e5d3a2f10",
  "steps": [
    {
      "step": "cycle",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:04.000Z",
      "completedAt": "2026-07-21T17:02:06.000Z",
      "detail": null
    },
    {
      "step": "stage:SELF",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:06.000Z",
      "completedAt": "2026-07-21T17:02:08.000Z",
      "detail": null
    },
    {
      "step": "stage:MANAGER",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:08.000Z",
      "completedAt": "2026-07-21T17:02:11.000Z",
      "detail": null
    },
    {
      "step": "releases",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:11.000Z",
      "completedAt": "2026-07-21T17:02:12.000Z",
      "detail": null
    },
    {
      "step": "complete",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:12.000Z",
      "completedAt": "2026-07-21T17:02:12.000Z",
      "detail": null
    }
  ],
  "error": null,
  "completedAt": "2026-07-21T17:02:12.000Z"
}

{
  "jobId": "019f4a10-3c2e-7a91-b6d4-1f0a2c9e8b77",
  "status": "IMPORTING",
  "cycleId": "019f4a10-3c2d-7f42-a8c1-9b6e5d3a2f10",
  "steps": [
    {
      "step": "cycle",
      "status": "COMPLETED",
      "startedAt": "2026-07-21T17:02:04.000Z",
      "completedAt": "2026-07-21T17:02:06.000Z",
      "detail": null
    },
    {
      "step": "stage:SELF",
      "status": "RUNNING",
      "startedAt": "2026-07-21T17:02:06.000Z",
      "completedAt": null,
      "detail": null
    }
  ],
  "error": null,
  "completedAt": null
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Backfill job not found",
    "requestId": "019f2986-8ea9-79ff-8ac2-612072b7cca6"
  }
}

Getting started

Windy

Org Chart

Features

Company settings

Account & admin

Developers

Data

Security and Compliance

Authorization

Path parameters

Response

Errors

​Authorization

​Path parameters

​Response

​Errors

Authorization

Path parameters

Response

Errors