API Reference

Slug-based public endpoints powering the customer portal. No API key required — the unique customer slug acts as authentication. All portal routes are read/write scoped to a single customer.

Optional JWT-based login for customer portal accounts. When enabled, customers log in with email + password and receive a session cookie. This is separate from the slug-based access — slug routes work without authentication.

Endpoints used by the customer-facing quote submission form. Files are uploaded first with a temporary token, then the full job is submitted in one POST which links all uploaded files.

Public job lookup endpoint used by the Kontraktr™ QR scanner. When a QR code is scanned, authenticated staff are redirected to the job modal; unauthenticated visitors see a public status card.

Public AssetLab™ digital asset store. Browse and search published designs without authentication. Design template data is only returned after purchase.

Public pricing endpoint. Returns the full pricing matrix (quantity tiers × color counts) used by the customer-facing quote calculator. Can optionally calculate a specific quote.

Validate discount codes during checkout or quote submission without exposing the full code database.

Jobs flow through a fixed production pipeline. The status field returned by all job endpoints uses these string values.

All endpoints enforce rate limits at the IP level. When a limit is hit, the server responds with HTTP 429 Too Many Requests and a Retry-After header indicating seconds until retry.

{
  "error": "Human-readable error message"
}