SmakeSmake API Docs
EndpointsPreparation Orders

Show a preparation order

Open in ClaudeOpen in ChatGPT
GET
/preparation-orders/{preparationOrderId}

Returns the preparation order with the given preparationOrderId and its items while it awaits the approval (released).

While the approval round is open, rejection_comment holds the change request of a rejected item.

AuthorizationBearer

Authorization

apiToken
AuthorizationBearer <token>

API token of your production preparation platform, created under Configuration → API - see Setup → Authentication.

In: header

Path Parameters

preparationOrderId*integer

The ID of the preparation order.

Header Parameters

Accept*"application/json"

The API only responds with JSON - this header is mandatory on every request (see Setup → Headers).

Default"application/json"

Value in

  • "application/json"

Response Body

application/json

application/json

application/json

application/json

Request example
curl -X GET "https://example.com/preparation-orders/1" \  -H "Accept: application/json"
{  "id": 1,  "external_identifier": "SO-1000042",  "state": "released",  "items": [    {      "id": 1,      "type": "digitalisation",      "state": "released",      "rejection_comment": null,      "first_name": null,      "last_name": null,      "file_name": "logo-chest.svg",      "production_file_name": "logo-chest-v1.svg",      "preview_url": "https://cdn.smake.example/aB3dE9/signed?signature=8e56c7bd67bdf716821a2e8b789409cbab5798a8649a4b0bb47cd665fe7fef01",      "colors": [        {          "position": 1,          "detected": {            "name": "1800",            "hex": "#2F3032"          },          "color": {            "id": 12,            "name": "Black",            "hex": "#2F3032",            "external_identifier": "ES-1800"          }        },        {          "position": 2,          "detected": {            "name": "1147",            "hex": "#C41E3A"          },          "color": null        }      ],      "width_mm": 80,      "height_mm": 40,      "production_method": {        "handle": "screen-print",        "name": "Screen printing"      }    },    {      "id": 2,      "type": "digitalisation",      "state": "approved",      "rejection_comment": null,      "first_name": "Erika",      "last_name": "Mustermann",      "file_name": "leaf.png",      "production_file_name": "leaf-v1.svg",      "preview_url": "https://cdn.smake.example/kQ7mP2/signed?signature=8e56c7bd67bdf716821a2e8b789409cbab5798a8649a4b0bb47cd665fe7fef01",      "colors": [        {          "position": 1,          "detected": {            "name": "1800",            "hex": "#2F3032"          },          "color": {            "id": 12,            "name": "Black",            "hex": "#2F3032",            "external_identifier": "ES-1800"          }        }      ],      "width_mm": 52.3,      "height_mm": 38.5,      "production_method": null    }  ]}

Rate Limit

Smake Production Preparation API - Rate Limit

Create a customer token for a preparation order POST

Creates a short-lived customer token for one preparation order. The Smake web component authenticates the customer approval of this order with it (see [Setup → Authentication](/docs/production-preparation/2026-10-01/setup/authentication#customer-token)). A token can only be created for an order that requires the customer approval, while the order is `released`, i.e. awaiting the customer approval. Each call revokes the previously created token of the order. The token is valid until `expires_at` (6 hours by default) and is revoked as soon as the decisions are submitted, by the customer in the web component or in the production preparation platform.