API Endpoint Reference / Partner production

Poll a Slice job

GET https://api.printhiv3d.com/v1/slice-jobs/{sliceJobId}

Operation ID getSliceJob. Requires the production:read API key scope.

Returns the Slice job with the status of each item and prepared plate. Poll until the status is ready, held, or failed.

Parameters

NameInTypeRequiredDescription
sliceJobIdpathuuidYes

Responses

StatusDescription
200Default Response
401Default Response
403Default Response
404Default Response
503Default Response

200 response fields

FieldTypeRequiredDescription
preparationIduuidYes
sliceJobIduuidYes
status"waiting_for_source" | "preparing" | "held" | "ready" | "failed"Yes
createdAtdate-timeYes
holdsobject[]Yes
itemsobject[]Yes

401 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo

403 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo

404 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable"Yes
itemintegerNo
limitobjectNo
reasonsobject[]NoPresent on target_not_qualified: one entry for each refused item.

503 response fields

FieldTypeRequiredDescription
error"invalid_request" | "unauthorized" | "not_found" | "idempotency_conflict" | "output_not_ready" | "output_unavailable" | "request_too_large" | "source_not_found" | "target_not_found" | "target_not_qualified" | "material_not_qualified" | "preparation_disabled" | "preparation_unavailable"Yes
itemintegerNo
limitobjectNo
reasonsobject[]NoPresent on target_not_qualified: one entry for each refused item.

Example 200 response

{
  "preparationId": "d8c5b2e9-4a7f-4e16-a3d0-9f2b6c1e8a47",
  "sliceJobId": "d8c5b2e9-4a7f-4e16-a3d0-9f2b6c1e8a47",
  "status": "ready",
  "createdAt": "2026-11-04T18:00:00.000Z",
  "holds": [],
  "items": [
    {
      "index": 0,
      "status": "ready",
      "source": {
        "sourceVersionId": "5f8a2c6e-9d1b-4e73-b4a0-2c7e9f1d6b85",
        "externalId": "storefront-product-1042",
        "status": "ready"
      },
      "plates": [
        1
      ],
      "resolvedPlates": [
        1
      ],
      "quantity": 1,
      "materialMappings": [],
      "guidance": {
        "allowedMaterials": [],
        "preferredFilaments": []
      },
      "target": {
        "printerId": "7d3f1c2a-5b8e-4f6a-9c1d-2e4b6a8c0f13",
        "printerName": "Bay 3",
        "printerModel": "P1S",
        "nozzleDiameterMm": 0.4,
        "nozzleFlow": "standard",
        "buildSurface": "Textured PEI Plate"
      },
      "failure": null,
      "preparedPlates": []
    }
  ]
}