API Endpoint Reference / Print Jobs

List organization print jobs in queue order

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

Operation ID listPublicPrintJobs. Requires the read API key scope.

Requires an organization read key or verified organization session. Host credentials, including Host-bound wildcard keys, and production-scoped source credentials are rejected. Defaults to queued jobs. Includes unassigned work and jobs on non-ready or maintenance printers. Ordered by global rank, queue rank, creation time and ID, with null ranks last. This is a live queue view: moving or changing a job between requests can change its position. Repeat filters with the returned cursor; a cursor is not a snapshot or authority to control a job.

Parameters

NameInTypeRequiredDescription
statusesquerystringNo
printerIdsquerystringNo
limitqueryintegerNo
cursorquerystringNo

Responses

StatusDescription
200Default Response

200 response fields

FieldTypeRequiredDescription
jobsobject[]Yes
nextCursorstring | nullYes

Example 200 response

{
  "jobs": [
    {
      "id": 48213,
      "name": "Phone stand",
      "status": "QUEUED",
      "printerId": null,
      "progress": null,
      "globalQueueRank": 1024,
      "queueRank": null,
      "createdAt": "2026-11-04T18:00:00.000Z",
      "updatedAt": "2026-11-04T18:00:00.000Z",
      "startedAt": null,
      "completedAt": null
    }
  ],
  "nextCursor": null
}