API Endpoint Reference / Print Jobs
Read a batch that a send made, with its print requests
GET https://api.printhiv3d.com/v1/print-jobs/batches/{batchId}/requests
Operation ID getPrintJobBatch. Requires the read API key scope.
The batch status comes from its requests and their jobs. Requests are oldest first. A batch that no send made is 404.
Parameters
| Name | In | Type | Required | Description |
|---|
batchId | path | string | Yes | |
Responses
| Status | Description |
|---|
200 | Default Response |
404 | Default Response |
200 response fields
| Field | Type | Required | Description |
|---|
batchId | uuid | Yes | |
name | string | Yes | |
status | "PENDING" | "IN_PROGRESS" | "COMPLETED" | "FAILED" | "PARTIAL" | "CANCELLED" | Yes | |
schedulingHeld | boolean | Yes | |
closed | boolean | Yes | |
createdAt | string | Yes | |
source | object | null | Yes | |
requests | object[] | Yes | |
404 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
Example 200 response
{
"batchId": "b6e3a9d1-7c4f-4b28-9e0a-5d1c8f3b7a62",
"name": "phone-stand.3mf",
"status": "PENDING",
"schedulingHeld": false,
"closed": false,
"createdAt": "2026-11-04T18:00:00.000Z",
"source": {
"sourceVersionId": "5f8a2c6e-9d1b-4e73-b4a0-2c7e9f1d6b85",
"filename": "phone-stand.3mf",
"modelFileId": "e2b7c9d4-1f6a-4c38-9b0e-7a5d3f8c1e26",
"sentAt": "2026-11-04T18:00:00.000Z"
},
"requests": [
{
"requestId": "a91d4f7c-3e2b-4a6d-8c5f-0b7e2d9a4c18",
"status": "created",
"externalId": "order-1042-line-1",
"createdAt": "2026-11-04T18:00:00.000Z",
"job": {
"id": 48213,
"status": "queued",
"model_file_id": "e2b7c9d4-1f6a-4c38-9b0e-7a5d3f8c1e26",
"printer_id": "7d3f1c2a-5b8e-4f6a-9c1d-2e4b6a8c0f13",
"print_options": {}
},
"requiredActions": [],
"error": null
}
]
}