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
| Name | In | Type | Required | Description |
|---|
requestId | path | string | Yes | Creation request UUID. Invalid or inaccessible IDs return 404. |
Responses
| Status | Description |
|---|
200 | Default Response |
400 | Invalid request or organization scope |
401 | Authentication required |
403 | Insufficient API key scope or organization membership |
404 | Creation request not found |
500 | Unexpected server error |
503 | Creation request storage unavailable |
200 response fields
| Field | Type | Required | Description |
|---|
requestId | uuid | Yes | |
status | "preparing" | "held" | "created" | "failed" | "cancelled" | Yes | |
externalId | string | null | Yes | |
createdAt | string | Yes | |
plate | integer | null | No | |
printerId | uuid | null | No | |
name | string | null | No | |
sourceVersionId | uuid | null | No | |
job | object | null | Yes | |
requiredActions | object[] | Yes | |
warnings | object[] | No | |
error | object | null | Yes | |
batchId | uuid | null | No | |
attempt | integer | No | |
retryOf | uuid | null | No | |
retriedBy | uuid | null | No | |
superseded | boolean | No | |
variants | object[] | No | |
filaments | object[] | No | |
estimatedSeconds | integer | null | No | |
createdJobId | integer | null | No | |
modelFileId | uuid | null | No | |
400 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
401 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
403 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
404 response fields
| Field | Type | Required | Description |
|---|
error | string | Yes | |
message | string | No | |
requestId | string | No | |
500 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
503 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
code | string | No | |
statusCode | integer | No | |
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
}