Quickstart

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

---

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 automation

Only move into RFQ detail, quote, order, or webhook automation after those operations are present in /docs/api/openapi.yaml for your environment and your registry entitlement explicitly enables them.

---

5. Keep webhook work rollout-gated

Signed webhook handling is required for approved event-delivery pilots, but quote/order webhook delivery is not a public-current production enablement. Treat webhook setup as private-beta until your contract, key registry scopes, and rollout state confirm it.

---

Next: Authentication ->