Endpoints · Events
GET/v1/events
What happened since an event: the catch-up for webhooks.
What it does
The organisation's events after the one named, oldest first: the catch-up for anything a webhook missed. The list is organisation-wide for any key; a test key lists the test events ("livemode": false in data) and a live key the real ones. has_more says whether to call again with the last id. Pings from Send a test are not listed.
Send the key: Authorization: Bearer sk_test_… or sk_live_….
curl "https://printwisp.com/v1/events?after=evt_7c2e9a1d4b8f3065&limit=50" \
-H "Authorization: Bearer $PRINTWISP_KEY"
# 200
{
"events": [
{
"id": "evt_8a0d3c7e1f5b2946",
"type": "order.created",
"created": "2026-10-05T04:31:02+00:00",
"data": { "order": "ord_7d1e4b9a2c6f0583", "order_ref": "WEB-10021" }
},
{
"id": "evt_9b1e4d8f2a6c3057",
"type": "design.print_ready",
"created": "2026-10-05T04:31:40+00:00",
"data": { "order": "ord_7d1e4b9a2c6f0583", "line": "oln_41aa8c3e9d2b7f16" }
}
],
"has_more": false
}<?php
$ch = curl_init('https://printwisp.com/v1/events?after=evt_7c2e9a1d4b8f3065&limit=50');
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/events?after=evt_7c2e9a1d4b8f3065&limit=50', {
headers: { Authorization: 'Bearer ' + process.env.PRINTWISP_KEY },
});
const answer = await r.json();import os, requests
r = requests.get(
"https://printwisp.com/v1/events?after=evt_7c2e9a1d4b8f3065&limit=50",
headers={"Authorization": f"Bearer {os.environ['PRINTWISP_KEY']}"},
)
answer = r.json()Parameters
| Parameter | Type | Description |
|---|---|---|
after | string | An event id (evt_…); empty starts from the first event. |
limit | integer 1–200 | How many, 1 to 200. |
Response
200 application/json. The events.
{
"events": [
{
"id": "evt_8a0d3c7e1f5b2946",
"type": "order.created",
"created": "2026-10-05T04:31:02+00:00",
"data": { "order": "ord_7d1e4b9a2c6f0583", "order_ref": "WEB-10021" }
},
{
"id": "evt_9b1e4d8f2a6c3057",
"type": "design.print_ready",
"created": "2026-10-05T04:31:40+00:00",
"data": { "order": "ord_7d1e4b9a2c6f0583", "line": "oln_41aa8c3e9d2b7f16" }
}
],
"has_more": false
}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 event with that id. |