API Endpoint Reference / Print Jobs
List organization print jobs in queue order
GET https://api.printhiv3d.com/ v1/ print-jobsOperation 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
| Name | In | Type | Required | Description |
|---|---|---|---|---|
statuses | query | string | No | |
printerIds | query | string | No | |
limit | query | integer | No | |
cursor | query | string | No |
Responses
| Status | Description |
|---|---|
200 | Default Response |
200 response fields
| Field | Type | Required | Description |
|---|---|---|---|
jobs | object[] | Yes | |
nextCursor | string | null | Yes |
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
}