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

NameInTypeRequiredDescription
sourceVersionIdqueryuuidYes

Responses

StatusDescription
200Default Response
400Invalid query
401Authentication required
403API key requires read scope
503Creation requests unavailable

200 response fields

FieldTypeRequiredDescription
batchesobject[]Yes

400 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo

401 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

403 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo
codestringNo
statusCodeintegerNo

503 response fields

FieldTypeRequiredDescription
errorstringNo
messagestringNo
requestIdstringNo

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