Endpoints · Orders
GET/v1/print
A line's print status and, when ready, a 10-minute link.
What it does
A test line (oln_t…) answers only to a test key, a real line only to a live key. print_status moves queued → rendering → ready, or failed with an error. When it is ready the answer adds a signed url with its expires_at, good for 10 minutes, pointing at GET /v1/file. components says what the line is made of; fields holds the shopper's answers.
Send the key: Authorization: Bearer sk_test_… or sk_live_….
curl "https://printwisp.com/v1/print?line=oln_41aa8c3e9d2b7f16" \
-H "Authorization: Bearer $PRINTWISP_KEY"
# 200
{
"line": "oln_41aa8c3e9d2b7f16",
"order_ref": "WEB-10021",
"design": "dsn_5c2a9e01b7d4f638",
"print_status": "ready",
"components": [],
"fields": [],
"url": "https://printwisp.com/v1/file?l=oln_41aa8c3e9d2b7f16&e=1759640400&s=9f2c4e1a7b3d8f05c6e2a9d1b4f7c3e8a5d2b9f6c1e4a7d3b8f5c2e9a6d1b4f7",
"expires_at": "2026-10-05T04:51:00+00:00"
}<?php
$ch = curl_init('https://printwisp.com/v1/print?line=oln_41aa8c3e9d2b7f16');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('PRINTWISP_KEY'), 'Content-Type: application/json'],
]);
$answer = json_decode(curl_exec($ch), true);// Node (your server). The key never reaches a browser.
const r = await fetch('https://printwisp.com/v1/print?line=oln_41aa8c3e9d2b7f16', {
headers: { Authorization: 'Bearer ' + process.env.PRINTWISP_KEY },
});
const answer = await r.json();import os, requests
r = requests.get(
"https://printwisp.com/v1/print?line=oln_41aa8c3e9d2b7f16",
headers={"Authorization": f"Bearer {os.environ['PRINTWISP_KEY']}"},
)
answer = r.json()Parameters
| Parameter | Type | Description |
|---|---|---|
line required | string | The order line (oln_…). |
test | string | 1 reads a test order line with a live key. |
Response
200 application/json. The line's print status.
{
"line": "oln_41aa8c3e9d2b7f16",
"order_ref": "WEB-10021",
"design": "dsn_5c2a9e01b7d4f638",
"print_status": "ready",
"components": [],
"fields": [],
"url": "https://printwisp.com/v1/file?l=oln_41aa8c3e9d2b7f16&e=1759640400&s=9f2c4e1a7b3d8f05c6e2a9d1b4f7c3e8a5d2b9f6c1e4a7d3b8f5c2e9a6d1b4f7",
"expires_at": "2026-10-05T04:51:00+00:00"
}Errors
| HTTP | error | message |
|---|---|---|
| 401 | unauthorized | Send Authorization: Bearer <secret key>. Keys are made in PrintWisp, on your store's Overview → API keys. |
| 404 | not_found | No order line with that id. |