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
| Name | In | Type | Required | Description |
|---|
status | query | string | No | Comma-separated statuses to keep: preparing, held, created, failed, or cancelled. Omit it to keep every status. |
since | query | date-time | No | Keep requests created at or after this ISO 8601 timestamp, with an offset. |
batch | query | "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. |
limit | query | integer | No | Requests in one page. |
cursor | query | string | No | The `nextCursor` of the previous page. Repeat the same status, since and batch with it. |
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 |
|---|
requests | object[] | Yes | |
nextCursor | string | null | 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
{
"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
}