API Endpoint Reference / Print Jobs
List the batches that sends of one source version made
GET https://api.printhiv3d.com/v1/print-jobs/sends
Operation ID listPrintJobSends. Requires the read API key scope.
Newest first, at most 20 batches, each with its requests. Requests sent before batches existed are in `GET /v1/print-jobs/create-requests` only.
Parameters
| Name | In | Type | Required | Description |
|---|
sourceVersionId | query | uuid | Yes | |
Responses
| Status | Description |
|---|
200 | Default Response |
400 | Invalid query |
401 | Authentication required |
403 | API key requires read scope |
503 | Creation requests unavailable |
200 response fields
| Field | Type | Required | Description |
|---|
batches | object[] | Yes | |
400 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | 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 | |
503 response fields
| Field | Type | Required | Description |
|---|
error | string | No | |
message | string | No | |
requestId | string | No | |
Example 200 response
{
"batches": [
{
"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
}
]
}
]
}