API Endpoint Reference / Print Jobs

Poll one asynchronous single-plate creation request

GET https://api.printhiv3d.com/v1/print-jobs/create-requests/{requestId}

Operation ID getPrintJobCreateRequest. Requires the read API key scope.

Parameters

NameInTypeRequiredDescription
requestIdpathstringYesCreation request UUID. Invalid or inaccessible IDs return 404.

Responses

StatusDescription
200Default Response
400Invalid request or organization scope
401Authentication required
403Insufficient API key scope or organization membership
404Creation request not found
500Unexpected server error
503Creation request storage unavailable

200 response fields

FieldTypeRequiredDescription
requestIduuidYes
status"preparing" | "held" | "created" | "failed" | "cancelled"Yes
externalIdstring | nullYes
createdAtstringYes
plateinteger | nullNo
printerIduuid | nullNo
namestring | nullNo
sourceVersionIduuid | nullNo
jobobject | nullYes
requiredActionsobject[]Yes
warningsobject[]No
errorobject | nullYes
batchIduuid | nullNo
attemptintegerNo
retryOfuuid | nullNo
retriedByuuid | nullNo
supersededbooleanNo
variantsobject[]No
filamentsobject[]No
estimatedSecondsinteger | nullNo
createdJobIdinteger | nullNo
modelFileIduuid | nullNo

400 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

401 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

403 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

404 response fields

FieldTypeRequiredDescription
errorstringYes
messagestringNo
requestIdstringNo

500 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

503 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

Example 200 response

{
  "requestId": "a91d4f7c-3e2b-4a6d-8c5f-0b7e2d9a4c18",
  "status": "preparing",
  "externalId": "order-1042-line-1",
  "createdAt": "2026-11-04T18:00:00.000Z",
  "job": null,
  "requiredActions": [],
  "error": null,
  "plate": 1,
  "printerId": "7d3f1c2a-5b8e-4f6a-9c1d-2e4b6a8c0f13",
  "name": "Phone stand",
  "sourceVersionId": "5f8a2c6e-9d1b-4e73-b4a0-2c7e9f1d6b85",
  "warnings": [],
  "batchId": null,
  "attempt": 1,
  "retryOf": null,
  "retriedBy": null,
  "superseded": false
}