Read one order, with its history
const url = 'https://api.pixonaut.app/v1/orders/example';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 \ --header 'Authorization: Bearer <token>'Operation ID: orders.get
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Responses
Section titled “Responses”The order, its history, and whether it can be submitted again
object
The blank blankId names, as it reads now; null as blankId is.
object
Its option axes, in order: how a variant’s options read, such as Color then Size.
How many variants it has, retired ones included.
The blank the order’s prints are on; null for prints on no blank, or an order placed before it was recorded.
The order’s latest address change, made with PATCH /v1/orders/{id}/delivery after the order was sent; null for an order whose address never changed.
object
When the change was made.
What the printshop made of the change: sending while it is being told, accepted, refused (the order keeps the address the printshop has), or carried when what the printshop had not been sent yet carries the new address, so nothing extra was sent.
The printshop’s own answer to a refused change; null otherwise.
The order’s address changes, oldest first, each as its order.delivery_changed event recorded it. Never the address.
object
The order had no address before: one was added.
When the change was made, or answered.
Who made it: a studio member, the customer on the design’s address capture page, a connected store’s integration key (store_key), or a secret_key.
What the printshop made of it at at: a change sending is listed again once it is answered.
The printshop’s own answer to a refused change.
The design the lead print was made from.
Why Pixonaut failed the order rather than its printshop, as a refusal code: print_failed (a print of it could not be made; lastError names it), prints_timed_out (its prints were not finished within three hours of placing it), or the refusal an order waiting for its prints met when it was handed on, such as technique_not_offered. null for an order its printshop refused, or one not failed.
object
The automation that moved it, by the name it had then; null unless via is automation.
object
What released a held order, on order.released: the workspace’s upgrade or the month_reset; null otherwise.
Why the order is held, while it is; null for an order not held. A held order is accepted and not handed to its printshop until the month resets with room for it or the workspace upgrades.
object
The plan’s monthly order limit the order met.
When the month resets (ISO 8601, UTC): the latest the order is released, if the new month has room for it.
Why it is held: monthly_order_limit, the workspace has placed the orders its plan includes this month. Show a reason you do not know as held without one, never as a failure.
The order’s lead print: the first of printIds, and the only one of an order of one print.
Every print the order holds, the lead first: the prints of one item, each in its own placement on its blank.
printIds with each print’s design, placement and file.
object
The revision of the design the print was made from: GET /v1/designs/{id}/revisions/{revision}/image draws it.
The placement fields the printshop was sent for this print, from its position there; null for an order placed before they were recorded.
object
Where the value came from: the variant’s (or position’s) own, the field’s default, or nothing, sent empty.
The placement on its blank the print’s design was committed for; null for a design with no blank, or one committed before placements were recorded.
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.
Which of this print’s files the printshop was sent; null while the order waits for its prints (awaiting_prints).
Where the print has got to: created while it renders, which an order in awaiting_prints waits for, then completed, or failed.
object
A fill print is made from no design.
A fill print: an optional placement of the blank the order left undesigned, printed flat in this colour (#rrggbb), its fill colour, at the placement’s whole area.
The placement fields the printshop was sent for this print, from its position there; null for an order placed before they were recorded.
object
Where the value came from: the variant’s (or position’s) own, the field’s default, or nothing, sent empty.
The placement on its blank the print’s design was committed for; null for a design with no blank, or one committed before placements were recorded.
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.
Which of this print’s files the printshop was sent; null while the order waits for its prints (awaiting_prints).
Where the print has got to: created while it renders, which an order in awaiting_prints waits for, then completed, or failed.
The printshop as it was when the order was placed: its name and kind (adapter). null for an order placed before it was recorded.
object
Who the order is for: its customer. When shipTo is set, the order ships there and the customer is who it is finally for.
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.
Whether mail to the recipient’s email bounced, so none is sent to it until the address changes; false for a recipient with no email, or none.
The order submitted to replace this one, which names it as replacesOrderId; null for none.
The failed order this one was submitted to replace; null for an order that replaces none.
The reroutes this order took part in, by POST /v1/orders/{id}/retry with reroute, oldest first: the one that sent it here (target), then the one that sent it on to another blank (original), each naming both blanks, variants and printshops as their orders were placed. Empty for an order not rerouted.
object
object
The blank’s option axes, in order: how variantOptions read.
object
The blank’s option axes, in order: how variantOptions read.
The workspace’s saved address the order ships to, as it was when the order was placed; null for an order that ships to its customer’s address. Its printshop is handed this address, and erasing the order’s personal data leaves it.
object
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.
What the address is called in the workspace, such as Warehouse: unique there, case aside, and the name a parcel sent there is addressed to. Up to 200 characters.
The saved address the order ships to, by id. It may have been changed or removed since; name and address are what the order was placed with.
The customer’s address. Where the order ships, unless shipTo is set.
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.
The statuses this caller may set the order to now with PATCH /v1/orders/{id}: for an integration key or a studio member on live, submitted and failed while its outcome is unknown and nothing otherwise; in a sandbox, every move a secret key may make. Empty for a caller without orders:update.
object
Who carries it, such as DHL.
The shipment’s tracking number.
Where the shipment is followed: an https address.
The variant as it was when the order was placed: its options and the variant fields its printshop was sent. A later edit of the variant does not change it.
object
Each declared field, in the printshop’s order, as it was sent.
object
Where the value came from: the variant’s (or position’s) own, the field’s default, or nothing, sent empty.
object
The variant the order names; null as blankId is.
Examples
Example
{ "adapter": "custom", "blank": { "name": "Classic tee", "optionAxes": [ "Color", "Size" ], "variants": 12 }, "blankId": "blank_classic_tee", "canErase": true, "canRetry": false, "delivery": null, "deliveryChangeRefusal": { "code": "order_past_address_change", "status": "shipped", "unanswered": true }, "deliveryChanges": [ { "added": false, "at": 1791890047000, "by": "member", "outcome": "accepted", "words": null } ], "designId": "6f1c8a2b-3d4e-4f5a-8b6c-7d8e9f0a1b2c", "erasable": true, "externalOrderRef": null, "externalRef": "WEB-10482-1", "failureKind": null, "fallbackSpots": [], "history": [ { "at": 1791886447000, "automation": null, "reason": null, "releasedBy": null, "seq": 1, "status": "submitted", "type": "order.submitted", "via": null }, { "at": 1791886505000, "automation": null, "reason": null, "releasedBy": null, "seq": 2, "status": "queued", "type": "order.status_changed", "via": "integration" }, { "at": 1791965647000, "automation": null, "reason": null, "releasedBy": null, "seq": 3, "status": "shipped", "type": "order.status_changed", "via": "secret_key" } ], "hold": null, "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b", "lastCheckedAt": 1791965647000, "lastError": null, "personalDataErasedAt": null, "printId": "c4d5e6f7-a8b9-4c0d-9e1f-2a3b4c5d6e7f", "printIds": [ "c4d5e6f7-a8b9-4c0d-9e1f-2a3b4c5d6e7f" ], "prints": [ { "designId": "6f1c8a2b-3d4e-4f5a-8b6c-7d8e9f0a1b2c", "designRevision": 1, "placementFields": [ { "name": "pos", "source": "own", "value": "FR" } ], "placementId": "front", "printId": "c4d5e6f7-a8b9-4c0d-9e1f-2a3b4c5d6e7f", "printedAs": "Front", "spotOutput": "process", "status": "completed" } ], "printshopAsPlaced": { "adapter": "custom", "name": "Nordic Print Works" }, "printshopConnectionId": "0b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e", "printshopName": "Nordic Print Works", "quantity": 25, "recipient": { "name": "Alexandra Lind", "phone": "+44 7700 900123" }, "recipientEmailBounced": false, "replacedByOrderId": null, "replacesOrderId": null, "reroutes": [], "retryable": false, "shipTo": null, "shippingAddress": { "city": "London", "country": "GB", "line1": "12 High Street", "line2": "Floor 2", "postalCode": "SW1A 1AA" }, "spotOutput": "process", "status": "shipped", "statusMoves": [], "submittedAt": 1791886447000, "tenantId": "acme", "tracking": { "carrier": "PostNord", "number": "00370725001234567890", "url": "https://tracking.postnord.com/en/?id=00370725001234567890" }, "updatedAt": 1791965647000, "variant": { "fields": [ { "name": "colorCode", "source": "own", "value": "WHT" }, { "name": "sizeCode", "source": "own", "value": "M" } ], "options": { "Color": "White", "Size": "M" }, "ref": "v_3f9a1c2b7d4e8a01" }, "variantRef": "v_3f9a1c2b7d4e8a01", "varnishLeftOut": false}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, forbidden, feature_disabled, workspace_suspended
object
The feature the tenant does not have. Always sent with feature_disabled.
Examples
feature_disabled
{ "error": "feature_disabled", "feature": "api"}forbidden
{ "error": "forbidden"}origin_forbidden
{ "error": "origin_forbidden"}workspace_suspended
{ "error": "workspace_suspended"}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, not_found
object
Examples
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: 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].