Endpoints · My designs

GET/v1/projects/{project}

One design of the customer's.

What it does

The same row as the list, for one design the customer made or that joined their account.

Send the key: Authorization: Bearer sk_test_… or sk_live_….

GET /v1/projects/{project}

curl "https://printwisp.com/v1/projects/dsn_5c2a9e01b7d4f638?customer_ref=wp-user-12" \
  -H "Authorization: Bearer $PRINTWISP_KEY"

# 200
{
  "project": {
    "id": "dsn_5c2a9e01b7d4f638",
    "name": "Our Story",
    "cover": "https://printwisp.com/v1/preview?design=dsn_5c2a9e01b7d4f638&sig=3e1f…&v=1761300720",
    "product": { "code": "petite", "name": "The Petite" },
    "size": { "code": "petite-8x6", "name": "8×6 in Landscape" },
    "pages": 20,
    "updated_at": "2026-10-24T06:32:00+00:00",
    "status": "in_progress",
    "order_ref": null,
    "link": { "emailed_at": "2026-10-24T06:32:00+00:00", "to": "s…h.t@gmail.com", "reminder": false },
    "joined": "email",
    "note": "saved_by_email"
  }
}

<?php
$ch = curl_init('https://printwisp.com/v1/projects/dsn_5c2a9e01b7d4f638?customer_ref=wp-user-12');
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/projects/dsn_5c2a9e01b7d4f638?customer_ref=wp-user-12', {
  headers: { Authorization: 'Bearer ' + process.env.PRINTWISP_KEY },
});
const answer = await r.json();

import os, requests

r = requests.get(
    "https://printwisp.com/v1/projects/dsn_5c2a9e01b7d4f638?customer_ref=wp-user-12",
    headers={"Authorization": f"Bearer {os.environ['PRINTWISP_KEY']}"},
)
answer = r.json()

Parameters

Parameter	Type	Description
`project` required	string	The design's id (`dsn_…`) from the list.
`customer_ref` required	string ≤ 190	Your signed-in customer, as you send it to POST /v1/sessions (`wp-user-12`, `shopify-customer-6061…`, your own id).

Response

200 application/json. The design.

200

JSON

Copy

{
  "project": {
    "id": "dsn_5c2a9e01b7d4f638",
    "name": "Our Story",
    "cover": "https://printwisp.com/v1/preview?design=dsn_5c2a9e01b7d4f638&sig=3e1f…&v=1761300720",
    "product": { "code": "petite", "name": "The Petite" },
    "size": { "code": "petite-8x6", "name": "8×6 in Landscape" },
    "pages": 20,
    "updated_at": "2026-10-24T06:32:00+00:00",
    "status": "in_progress",
    "order_ref": null,
    "link": { "emailed_at": "2026-10-24T06:32:00+00:00", "to": "s…h.t@gmail.com", "reminder": false },
    "joined": "email",
    "note": "saved_by_email"
  }
}

Errors

HTTP	error	message
401	`unauthorized`	Send Authorization: Bearer <secret key>. Keys are made in PrintWisp, on your store's Overview → API keys.
404	`project_not_found`	No design with that id for this customer.
422	`invalid_request`	Say whose designs with customer_ref: your signed-in customer's id, as you send it to POST /v1/sessions.

422

JSON

Copy

{
  "error": "invalid_request",
  "message": "Say whose designs with customer_ref: your signed-in customer's id, as you send it to POST /v1/sessions."
}

← Every route Quickstart →