---
title: "Get a bulk variant job"
description: "Check the status of a bulk variant-admin job."
url: https://docs.stoqapp.com/v2-reference/preorders-product-variants/get-a-bulk-variant-job/
api: "API v2 reference"
method: GET
path: "/preorders/product_variants/jobs/{job_id}"
---

# Get a bulk variant job

`GET https://app.stoqapp.com/api/v2/external/preorders/product_variants/jobs/{job_id}`

Check the status of a bulk variant-admin job.

**Note:** state is queued (waiting for a worker), running, stalled (nothing moved for stall_after_seconds; stalled_reason not_started or no_progress), completed, failed or cancelled. status is kept as before and reads running while the job is queued. Timestamps are UTC. Jobs are kept for 24 hours. A bulk variant job completes even when some variants fail: succeeded_count, failed_count and failed (each failed variant's shopify_variant_id and error) say which.

## Path parameters

- `job_id` (string, required): The job ID a bulk variant call returned.

## Returns

The [product variant object](https://docs.stoqapp.com/v2-reference/preorders-product-variants/).

Rate limit: this call costs 1 point ([rate limits](https://docs.stoqapp.com/docs/rate-limits/)).

## Example request

```sh
curl "https://app.stoqapp.com/api/v2/external/preorders/product_variants/jobs/{job_id}" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

## 200

Success: example response shown.

```json
{
  "job_id": "bulk_sync_metafields_5e8b2d0c9a4f7136",
  "status": "completed",
  "progress": 100,
  "total": 3,
  "processed": 3,
  "state": "completed",
  "stalled_reason": null,
  "created_at": "2026-06-25T14:02:11Z",
  "started_at": "2026-06-25T14:02:12Z",
  "last_progress_at": null,
  "finished_at": "2026-06-25T14:02:15Z",
  "stall_after_seconds": 900
}
```

## 401

Missing or invalid `X-Auth-Token`.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "auth_invalid",
  "details": [
    {
      "code": "auth_invalid",
      "message": "Invalid API key",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 404

The resource does not exist for this shop, or the action path is not registered.

```json
{
  "errors": [
    "Offer not found"
  ],
  "code": "not_found",
  "details": [
    {
      "code": "not_found",
      "message": "Offer not found",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 422

The request failed validation.

```json
{
  "errors": [
    "name is required"
  ],
  "code": "validation_failed",
  "details": [
    {
      "code": "validation_failed",
      "message": "name is required",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 429

Rate limited: cost-weighted per token (read 1, write 2; 360 points / 60s). Check `Retry-After`.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited",
  "details": [
    {
      "code": "rate_limited",
      "message": "Rate limit exceeded",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

