Read an order as its printshop makes it
const url = 'https://api.pixonaut.app/v1/orders/example/job';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.pixonaut.app/v1/orders/example/job \ --header 'Authorization: Bearer <token>'Operation ID: orders.job.get
Where the order stands, how it ships once shipped, and the job ticket to make it by: the print’s ticket with the order’s copies, recipient and address. ticket is the lead print’s, for machineProfile when it is asked; prints holds every print of the order, the lead first, each with its ticket for its own machine. A failed or cancelled order has no ticket.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Query Parameters
Section titled “Query Parameters”Responses
Section titled “Responses”The order’s job
object
The carriers the order’s printshop has shipped with, from this page or a secret key’s move here.
object
The carrier its latest shipment named, typed or listed; null before its first.
Carriers the printshop typed itself rather than picked from the page’s list, the most recently used first.
How many carriers the printshop typed itself in all.
object
object
Where on the item the print goes, by the name the order’s printshop knows it by (its Printed as), recorded when the order was placed; null for a print on no blank, or an order placed before it was recorded.
This print’s ticket for its own machine: machineProfile applies to the order’s ticket alone.
object
object
object
object
object
object
object
object
How the print aligns to the reference: top-left, top-center, top-right, center-left, center, center-right, bottom-left, bottom-center or bottom-right. Anything else is read as center.
How far the print is moved from the reference, in millimetres. y grows downward.
object
Horizontal offset in millimetres; positive moves right.
Vertical offset in millimetres; positive moves down.
The physical reference the print is positioned against on the product.
object
The linked group the design is one placement of: one design drives every placement it names. Absent for a design on one placement alone.
object
Whether this placement’s print is mirrored left to right.
The group’s placements, by id.
The width of the group’s widest print area, in mm: what a repeat across the group is sized against, so it prints at one physical scale on every placement.
The repeat the print was drawn as: the design’s mode, size and seed, and the printed size of the tile laid across the print. Absent for a print that does not repeat.
object
How the tiles are laid: grid lines them up, brick moves every other row along by half a tile, halfDrop moves every other column down by half a tile, and scatter strews them at random places, turns and sizes, arranged by seed.
Which arrangement a scatter draws: another seed is another arrangement of the same tile. Read by scatter only.
The tile’s width in percent of the print area’s width, above 0 and at most 100; the tile keeps the template’s shape. A tile that would print under 10 mm on a side is drawn at 10 mm.
The tile’s printed height in millimetres.
The tile’s printed width in millimetres.
object
True when the print shop cuts the product to this shape: the outline and the cut-outs go into the print file as its cut line. Omitted, the product already has the shape.
The shape as SVG path data in fractions of the print area, 0 to 1 across and down (curves, no arcs): its first subpath the outline, every further one a cut-out, filled even-odd, each subpath closed.
object
object
The recipient’s email address, for the carrier’s notices.
The recipient’s name as a parcel label carries it, a person’s or a company’s. Up to 200 characters.
The recipient’s phone number as the customer gave it, with the country code when it has one.
object
The city or town.
The company of a business address, which the parcel goes to; the recipient is who receives it.
The country as a two-letter ISO 3166-1 code in capitals, such as SE or US.
The first line of the street address: street and number.
The second line of the address: an apartment, floor or c/o.
The postal code as the country writes it, such as 111 22 or SW1A 1AA. Left out where the country has none; a printshop that needs one refuses the order postal_code_required.
The state, province or county, where the country uses one.
object
object
object
object
object
object
object
object
How the print aligns to the reference: top-left, top-center, top-right, center-left, center, center-right, bottom-left, bottom-center or bottom-right. Anything else is read as center.
How far the print is moved from the reference, in millimetres. y grows downward.
object
Horizontal offset in millimetres; positive moves right.
Vertical offset in millimetres; positive moves down.
The physical reference the print is positioned against on the product.
object
The linked group the design is one placement of: one design drives every placement it names. Absent for a design on one placement alone.
object
Whether this placement’s print is mirrored left to right.
The group’s placements, by id.
The width of the group’s widest print area, in mm: what a repeat across the group is sized against, so it prints at one physical scale on every placement.
The repeat the print was drawn as: the design’s mode, size and seed, and the printed size of the tile laid across the print. Absent for a print that does not repeat.
object
How the tiles are laid: grid lines them up, brick moves every other row along by half a tile, halfDrop moves every other column down by half a tile, and scatter strews them at random places, turns and sizes, arranged by seed.
Which arrangement a scatter draws: another seed is another arrangement of the same tile. Read by scatter only.
The tile’s width in percent of the print area’s width, above 0 and at most 100; the tile keeps the template’s shape. A tile that would print under 10 mm on a side is drawn at 10 mm.
The tile’s printed height in millimetres.
The tile’s printed width in millimetres.
object
True when the print shop cuts the product to this shape: the outline and the cut-outs go into the print file as its cut line. Omitted, the product already has the shape.
The shape as SVG path data in fractions of the print area, 0 to 1 across and down (curves, no arcs): its first subpath the outline, every further one a cut-out, filled even-odd, each subpath closed.
object
object
The recipient’s email address, for the carrier’s notices.
The recipient’s name as a parcel label carries it, a person’s or a company’s. Up to 200 characters.
The recipient’s phone number as the customer gave it, with the country code when it has one.
object
The city or town.
The company of a business address, which the parcel goes to; the recipient is who receives it.
The country as a two-letter ISO 3166-1 code in capitals, such as SE or US.
The first line of the street address: street and number.
The second line of the address: an apartment, floor or c/o.
The postal code as the country writes it, such as 111 22 or SW1A 1AA. Left out where the country has none; a printshop that needs one refuses the order postal_code_required.
The state, province or county, where the country uses one.
object
Who carries it, such as DHL.
The shipment’s tracking number.
Where the shipment is followed: an https address.
Examples
Example
{ "carriers": { "last": "PostNord", "saved": [ "Stadsbud Norr" ], "savedCount": 1 }, "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b", "machineProfileAskedId": null, "machineProfileId": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f", "machineProfiles": [ { "id": "5d6e7f80-9a1b-4c2d-8e3f-4a5b6c7d8e9f", "name": "Epson F2270 DTG" } ], "prints": [ { "placementId": "front", "printId": "c4d5e6f7-a8b9-4c0d-9e1f-2a3b4c5d6e7f", "printedAs": "Front", "ticket": { "artifact": { "colorSpace": "DeviceCMYK", "cut": { "bleedMm": 3, "cropMarks": false, "cutLine": false, "cutName": null, "markOffsetMm": 0, "mirrored": false, "part": "print", "profile": "Epson F2270 DTG", "registrationMarks": "none", "underbase": null, "varnish": null }, "effectiveDpi": 300, "file": "PR-2026-481920_c4d5e6f7.pdf", "format": "pdf", "iccProfile": "ISOcoated_v2_eci.icc", "includesBleed": true, "spotColors": [], "spotOutput": "process", "trimMarks": false }, "artwork": { "name": "Class of 2026", "templateId": "tshirt-basic@2" }, "externalRef": "WEB-10482-1", "fulfilmentPayload": { "variantSku": "TEE-BLACK-M" }, "manifest": { "docHash": "sha256:9f2c4e7a1b8d3f6052c7e9a4b1d8f3066a5e2c9b7d4f1830e6a2b5c8d9f10a37", "fontSetHash": "sha256:3c8e1a5f7b2d9046e1f8a3c6b9d25704a8e3f1c6b0d97245e8a1c3f6b9d2e508", "iccProfile": "ISOcoated_v2_eci.icc", "renderedAt": "2026-10-13T10:14:05Z", "rendererVersion": "0.14.2", "templateVersion": "tshirt-basic@2" }, "printArea": { "anchor": { "align": "center", "offsetMm": { "x": 0, "y": 80 }, "reference": "collar_seam" }, "bleedMm": 3, "cutShape": { "d": "M0 0 H250 V300 H0 Z", "type": "path" }, "heightMm": 300, "printMethod": "dtg", "widthMm": 250 }, "product": { "sku": "6f1c8a2b-3d4e-4f5a-8b6c-7d8e9f0a1b2c", "tenantId": "acme" }, "quantity": 25, "recipient": { "name": "Alexandra Lind", "phone": "+44 7700 900123" }, "shippingAddress": { "city": "London", "country": "GB", "line1": "12 High Street", "line2": "Floor 2", "postalCode": "SW1A 1AA" } } } ], "status": "queued", "submittedAt": 1791886447000, "ticket": { "artifact": { "colorSpace": "DeviceCMYK", "cut": { "bleedMm": 3, "cropMarks": false, "cutLine": false, "cutName": null, "markOffsetMm": 0, "mirrored": false, "part": "print", "profile": "Epson F2270 DTG", "registrationMarks": "none", "underbase": null, "varnish": null }, "effectiveDpi": 300, "file": "PR-2026-481920_c4d5e6f7.pdf", "format": "pdf", "iccProfile": "ISOcoated_v2_eci.icc", "includesBleed": true, "spotColors": [], "spotOutput": "process", "trimMarks": false }, "artwork": { "name": "Class of 2026", "templateId": "tshirt-basic@2" }, "externalRef": "WEB-10482-1", "fulfilmentPayload": { "variantSku": "TEE-BLACK-M" }, "manifest": { "docHash": "sha256:9f2c4e7a1b8d3f6052c7e9a4b1d8f3066a5e2c9b7d4f1830e6a2b5c8d9f10a37", "fontSetHash": "sha256:3c8e1a5f7b2d9046e1f8a3c6b9d25704a8e3f1c6b0d97245e8a1c3f6b9d2e508", "iccProfile": "ISOcoated_v2_eci.icc", "renderedAt": "2026-10-13T10:14:05Z", "rendererVersion": "0.14.2", "templateVersion": "tshirt-basic@2" }, "printArea": { "anchor": { "align": "center", "offsetMm": { "x": 0, "y": 80 }, "reference": "collar_seam" }, "bleedMm": 3, "cutShape": { "d": "M0 0 H250 V300 H0 Z", "type": "path" }, "heightMm": 300, "printMethod": "dtg", "widthMm": 250 }, "product": { "sku": "6f1c8a2b-3d4e-4f5a-8b6c-7d8e9f0a1b2c", "tenantId": "acme" }, "quantity": 25, "recipient": { "name": "Alexandra Lind", "phone": "+44 7700 900123" }, "shippingAddress": { "city": "London", "country": "GB", "line1": "12 High Street", "line2": "Floor 2", "postalCode": "SW1A 1AA" } }, "tracking": null}Headers
Section titled “Headers”Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.
Refused: unauthorized
object
Examples
unauthorized
{ "error": "unauthorized"}Headers
Section titled “Headers”Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.
Refused: origin_forbidden, secret_key_required, feature_disabled
object
The feature the tenant does not have. Always sent with feature_disabled.
Examples
feature_disabled
{ "error": "feature_disabled", "feature": "api"}origin_forbidden
{ "error": "origin_forbidden"}secret_key_required
{ "error": "secret_key_required"}Headers
Section titled “Headers”Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.
Refused: order_not_found, machine_profile_not_found, not_found
object
Examples
machine_profile_not_found
{ "error": "machine_profile_not_found"}not_found
{ "error": "not_found"}order_not_found
{ "error": "order_not_found"}Headers
Section titled “Headers”Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.
Refused: spot_plate_required
object
Always sent with spot_plate_required.
Always sent with spot_plate_required.
Examples
spot_plate_required
{ "cause": "printshop_takes_no_plates", "error": "spot_plate_required", "references": [ "string" ]}Headers
Section titled “Headers”Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.
Refused: rate_limited
object
Examples
rate_limited
{ "error": "rate_limited"}Headers
Section titled “Headers”Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.
Refused: db_error. A request that failed unexpectedly answers as text instead.
object
Examples
db_error
{ "error": "db_error"}Headers
Section titled “Headers”Every response names the request it answers in X-Request-Id: the id the request was sent with in that header, when it is well formed, else one the API gave it. Quote it when reporting a refusal or a failure: the API’s log lines for that request carry it.
Questions? Write to [email protected].