Quickstart

If you already have approved access and a sandbox key, this is the fastest path to a working Partner API integration.

---

1. Export your sandbox key

export NOWTOPRINT_API_KEY="ntp_test_your_key"

---

2. Request an estimate

curl -X POST https://api.nowtoprint.com/api/v1/estimate \
  -H "Authorization: Bearer $NOWTOPRINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "flyer",
    "quantity": 1000
  }'

---

3. Check RFQ launch posture

curl -i -X POST https://api.nowtoprint.com/api/v1/rfq \
  -H "Authorization: Bearer $NOWTOPRINT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-rfq-001" \
  -d '{
    "title": "Quickstart flyer order",
    "category": "flyer",
    "quantity": 1000,
    "deliveryCity": "Istanbul"
  }'

The current public contract returns 501 for RFQ create/list until the canonical L5 catalog/RFQ resolver is enabled. Build clients to handle that response explicitly instead of assuming a live RFQ id is returned.

---

4. Re-check the published contract before RFQ go-live

Only move into quote or order automation after those routes are present in /docs/api/openapi.yaml for your environment.

---

5. Wire webhooks before production

Do not ship a polling-only production integration. Add signed webhook handling for quote and order state changes so your downstream systems stay in sync.

---

Next: Authentication ->