API Endpoint Reference / Print Jobs

List the organization's creation requests, newest first

GET https://api.printhiv3d.com/v1/print-jobs/create-requests

Operation ID listPrintJobCreateRequests. Requires the read API key scope.

Newest first, by created time and then request id. `nextCursor` is the position of the last request on the page, and the next page starts strictly after it, so requests that share a created time never repeat or go missing. A walk is not a snapshot: a request that arrives above your cursor is not in the walk, so read the first page again to see it, and one that arrives below your cursor appears in its place. Held and failed requests stay in the list.

Parameters

NameInTypeRequiredDescription
statusquerystringNoComma-separated statuses to keep: preparing, held, created, failed, or cancelled. Omit it to keep every status.
sincequerydate-timeNoKeep requests created at or after this ISO 8601 timestamp, with an offset.
batchquery"none"No`none` keeps only requests that have no batch: those that `POST /v1/print-jobs/create` made, and those of a send with `batch: {unbatched: true}`. Omit it to keep every request.
limitqueryintegerNoRequests in one page.
cursorquerystringNoThe `nextCursor` of the previous page. Repeat the same status, since and batch with it.

Responses

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

200 response fields

FieldTypeRequiredDescription
requestsobject[]Yes
nextCursorstring | nullYes

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

{
  "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
    }
  ],
  "nextCursor": null
}