Machine-readable OpenAPI 3.0 specifications for all NowToPrint API surfaces — Partner REST API, XJDF/PrintTalk, and Preflight Engine. Import into Postman, Insomnia or Bruno to start testing immediately.

OpenAPI Explorer & Spec Reference

NowToPrint publishes machine-readable OpenAPI 3.0 specifications for all API surfaces. This page is your single entry point to download specs, explore interactively, and understand the contract across all APIs.

Available Specifications

Partner REST API — v1

Create RFQs, retrieve quotes, place and manage print orders programmatically.

XJDF / PrintTalk API — v1

CIP4 XJDF 2.2 and PrintTalk 2.2 B2B integration for MIS/ERP and workflow systems.

Preflight Engine API — v2

Submit PDF files for automated quality analysis. Returns structured DPI, bleed, colour and font reports.

Partner REST API

Overview

The Partner REST API is the primary integration surface for print buyers, white-label partners and marketplace aggregators. It follows REST conventions with JSON request/response bodies.

Base URL: https://api.nowtoprint.com

Authentication: X-API-Key header (obtain from your organisation settings under Developer)

GET /api/v1/rfq HTTP/1.1
Host: api.nowtoprint.com
X-API-Key: np_live_xxxxxxxxxxxxxxxxxxxx
Accept: application/json

Download & Explore

Format	Link
OpenAPI YAML	`/docs/api/openapi.yaml`
OpenAPI JSON	`/docs/api/openapi.json`

Import into Postman

In Postman: File → Import → paste the YAML URL above. All endpoints, parameters and example responses are pre-populated.

Core Endpoints

Method	Path	Description
`POST`	`/api/v1/rfq`	Create a new Request for Quote
`GET`	`/api/v1/rfq/{id}`	Get RFQ details and current bids
`POST`	`/api/v1/rfq/{id}/accept`	Accept a supplier bid
`GET`	`/api/v1/orders`	List orders for your organisation
`GET`	`/api/v1/orders/{id}`	Get order details and status
`POST`	`/api/v1/estimate`	Get an instant AI price estimate
`POST`	`/api/v1/preflight`	Submit a PDF for preflight analysis

Rate Limits

Window	Limit
Per minute	100 requests
Per hour	1 000 requests
Per day	10 000 requests

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1712700000

XJDF / PrintTalk API

Overview

The XJDF integration layer implements the CIP4 XJDF 2.2 and PrintTalk 2.2 standards for B2B interoperability with MIS, ERP and print-shop workflow software.

Transport: HTTPS REST — XML or JSON body
Authentication: Mutual TLS (mTLS) or X-API-Key header

Download & Explore

Format	Link
OpenAPI YAML	`/docs/api/xjdf-openapi.yaml`

Key Operations

Operation	PrintTalk Message	Description
Submit job	`PTK:Quotation`	Request a price quote
Accept quote	`PTK:PurchaseOrder`	Confirm order from quote
Check status	`JMF:Status`	Poll job/order status
Preflight	`XJDF:ConvertingConfig`	Submit file for quality check

Preflight Engine API

Overview

The Preflight Engine API v2 provides standalone PDF quality analysis. It is also available through the Partner REST API (POST /api/v1/preflight) for convenience.

Base URL: https://api.nowtoprint.com/v2
Authentication: X-API-Key header

Download & Explore

Format	Link
OpenAPI YAML	`/docs/api/preflight-openapi.yaml`

Submit a PDF for Preflight

POST /v2/analyze HTTP/1.1
Host: api.nowtoprint.com
X-API-Key: np_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "fileUrl": "https://cdn.example.com/artwork.pdf",
  "profile": "print_ready",
  "options": {
    "checkDpi": true,
    "checkBleed": true,
    "checkColorMode": true,
    "checkFontEmbedding": true
  }
}

Response Structure

{
  "status": "warning",
  "passed": false,
  "checks": {
    "dpi": { "status": "pass", "minDpi": 300, "foundDpi": 350 },
    "bleed": { "status": "warning", "required": 3, "found": 2 },
    "colorMode": { "status": "pass", "mode": "CMYK" },
    "fontEmbedding": { "status": "pass", "allEmbedded": true }
  },
  "summary": "PDF passed most checks but bleed margin is below 3 mm on the left edge.",
  "processedAt": "2026-04-09T00:00:00Z"
}

Developer Quickstart

The fastest way to integrate:

Download openapi.yaml and import it into Postman or Insomnia. Set the X-API-Key variable to your key.

curl -X POST https://api.nowtoprint.com/api/v1/rfq \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productType": "business_cards",
    "quantity": 500,
    "specifications": {
      "size": "85x55mm",
      "paper": "350gsm",
      "coating": "matt_laminate"
    },
    "deliveryAddress": {
      "country": "TR",
      "city": "Istanbul"
    }
  }'

curl https://api.nowtoprint.com/api/v1/rfq/rfq_xxx \
  -H "X-API-Key: YOUR_KEY"

Suppliers are notified automatically. Bids typically arrive within minutes during business hours.

Error Codes

All API errors follow RFC 7807 (Problem Details for HTTP APIs):

{
  "type": "https://api.nowtoprint.com/errors/rate-limit-exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "You have exceeded 100 requests per minute.",
  "retryAfter": 42
}

HTTP Status	Meaning
`400`	Bad request — invalid parameters
`401`	Missing or invalid API key
`403`	Forbidden — insufficient permissions
`404`	Resource not found
`422`	Unprocessable entity — business logic validation failed
`429`	Rate limit exceeded — back off and retry
`500`	Internal server error — contact support

Changelog

Date	Version	Change
2026-04-09	v1.2	Added `POST /api/v1/estimate` AI price estimation endpoint
2026-03-15	v1.1	Preflight Engine API promoted to v2, added structured check results
2026-01-10	v1.0	Initial Partner REST API release

Related: Partner API Guide · Authentication · Webhooks · XJDF API

OpenAPI Explorer & Spec Reference

Available Specifications

Partner REST API — v1

Create RFQs, retrieve quotes, place and manage print orders programmatically.

XJDF / PrintTalk API — v1

CIP4 XJDF 2.2 and PrintTalk 2.2 B2B integration for MIS/ERP and workflow systems.

Preflight Engine API — v2

Submit PDF files for automated quality analysis. Returns structured DPI, bleed, colour and font reports.

Partner REST API

Overview

The Partner REST API is the primary integration surface for print buyers, white-label partners and marketplace aggregators. It follows REST conventions with JSON request/response bodies.

Base URL: https://api.nowtoprint.com

Authentication: X-API-Key header (obtain from your organisation settings under Developer)

GET /api/v1/rfq HTTP/1.1
Host: api.nowtoprint.com
X-API-Key: np_live_xxxxxxxxxxxxxxxxxxxx
Accept: application/json

Download & Explore

Format	Link
OpenAPI YAML	`/docs/api/openapi.yaml`
OpenAPI JSON	`/docs/api/openapi.json`

Import into Postman

In Postman: File → Import → paste the YAML URL above. All endpoints, parameters and example responses are pre-populated.

Core Endpoints

Method	Path	Description
`POST`	`/api/v1/rfq`	Create a new Request for Quote
`GET`	`/api/v1/rfq/{id}`	Get RFQ details and current bids
`POST`	`/api/v1/rfq/{id}/accept`	Accept a supplier bid
`GET`	`/api/v1/orders`	List orders for your organisation
`GET`	`/api/v1/orders/{id}`	Get order details and status
`POST`	`/api/v1/estimate`	Get an instant AI price estimate
`POST`	`/api/v1/preflight`	Submit a PDF for preflight analysis

Rate Limits

Window	Limit
Per minute	100 requests
Per hour	1 000 requests
Per day	10 000 requests

Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1712700000

XJDF / PrintTalk API

Overview

The XJDF integration layer implements the CIP4 XJDF 2.2 and PrintTalk 2.2 standards for B2B interoperability with MIS, ERP and print-shop workflow software.

Transport: HTTPS REST — XML or JSON body
Authentication: Mutual TLS (mTLS) or X-API-Key header

Download & Explore

Format	Link
OpenAPI YAML	`/docs/api/xjdf-openapi.yaml`

Key Operations

Operation	PrintTalk Message	Description
Submit job	`PTK:Quotation`	Request a price quote
Accept quote	`PTK:PurchaseOrder`	Confirm order from quote
Check status	`JMF:Status`	Poll job/order status
Preflight	`XJDF:ConvertingConfig`	Submit file for quality check

Preflight Engine API

Overview

The Preflight Engine API v2 provides standalone PDF quality analysis. It is also available through the Partner REST API (POST /api/v1/preflight) for convenience.

Base URL: https://api.nowtoprint.com/v2
Authentication: X-API-Key header

Download & Explore

Format	Link
OpenAPI YAML	`/docs/api/preflight-openapi.yaml`

Submit a PDF for Preflight

POST /v2/analyze HTTP/1.1
Host: api.nowtoprint.com
X-API-Key: np_live_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{
  "fileUrl": "https://cdn.example.com/artwork.pdf",
  "profile": "print_ready",
  "options": {
    "checkDpi": true,
    "checkBleed": true,
    "checkColorMode": true,
    "checkFontEmbedding": true
  }
}

Response Structure

{
  "status": "warning",
  "passed": false,
  "checks": {
    "dpi": { "status": "pass", "minDpi": 300, "foundDpi": 350 },
    "bleed": { "status": "warning", "required": 3, "found": 2 },
    "colorMode": { "status": "pass", "mode": "CMYK" },
    "fontEmbedding": { "status": "pass", "allEmbedded": true }
  },
  "summary": "PDF passed most checks but bleed margin is below 3 mm on the left edge.",
  "processedAt": "2026-04-09T00:00:00Z"
}

Developer Quickstart

The fastest way to integrate:

Download openapi.yaml and import it into Postman or Insomnia. Set the X-API-Key variable to your key.

curl -X POST https://api.nowtoprint.com/api/v1/rfq \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productType": "business_cards",
    "quantity": 500,
    "specifications": {
      "size": "85x55mm",
      "paper": "350gsm",
      "coating": "matt_laminate"
    },
    "deliveryAddress": {
      "country": "TR",
      "city": "Istanbul"
    }
  }'

curl https://api.nowtoprint.com/api/v1/rfq/rfq_xxx \
  -H "X-API-Key: YOUR_KEY"

Suppliers are notified automatically. Bids typically arrive within minutes during business hours.

Error Codes

All API errors follow RFC 7807 (Problem Details for HTTP APIs):

{
  "type": "https://api.nowtoprint.com/errors/rate-limit-exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "You have exceeded 100 requests per minute.",
  "retryAfter": 42
}

HTTP Status	Meaning
`400`	Bad request — invalid parameters
`401`	Missing or invalid API key
`403`	Forbidden — insufficient permissions
`404`	Resource not found
`422`	Unprocessable entity — business logic validation failed
`429`	Rate limit exceeded — back off and retry
`500`	Internal server error — contact support

Changelog

Date	Version	Change
2026-04-09	v1.2	Added `POST /api/v1/estimate` AI price estimation endpoint
2026-03-15	v1.1	Preflight Engine API promoted to v2, added structured check results
2026-01-10	v1.0	Initial Partner REST API release

Related: Partner API Guide · Authentication · Webhooks · XJDF API

OpenAPI Explorer & Spec Reference

OpenAPI Explorer & Spec Reference

Available Specifications

Partner REST API — v1

XJDF / PrintTalk API — v1

Preflight Engine API — v2

Partner REST API

Overview

Download & Explore

Core Endpoints

Rate Limits

XJDF / PrintTalk API

Overview

Download & Explore

Key Operations

Preflight Engine API

Overview

Download & Explore

Submit a PDF for Preflight

Response Structure

Developer Quickstart

Error Codes

Changelog

Articles connexes

Sur cette page

OpenAPI Explorer & Spec Reference

OpenAPI Explorer & Spec Reference

Available Specifications

Partner REST API — v1

XJDF / PrintTalk API — v1

Preflight Engine API — v2

Partner REST API

Overview

Download & Explore

Core Endpoints

Rate Limits

XJDF / PrintTalk API

Overview

Download & Explore

Key Operations

Preflight Engine API

Overview

Download & Explore

Submit a PDF for Preflight

Response Structure

Developer Quickstart

Error Codes

Changelog

Articles connexes

Sur cette page