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

NameInTypeRequiredDescription
batchIdpathstringYes

Responses

StatusDescription
200Default Response
404Default Response

200 response fields

FieldTypeRequiredDescription
batchIduuidYes
namestringYes
status"PENDING" | "IN_PROGRESS" | "COMPLETED" | "FAILED" | "PARTIAL" | "CANCELLED"Yes
schedulingHeldbooleanYes
closedbooleanYes
createdAtstringYes
sourceobject | nullYes
requestsobject[]Yes

404 response fields

FieldTypeRequiredDescription
errorstringNo

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
    }
  ]
}