Skip to content
Lucent ImagingLucent Imaging icon
Getting started

Print API

Price and place fine art print, canvas and framing orders from your own system, packed and posted to your customer under your brand.

The Print API is for trade partners who sell printing they do not produce themselves - photographers with a client gallery, artists selling editions, galleries, and online stores. You send us the artwork and the specification; we print, frame, pack and post it to your customer.

Orders are billed to your trade account rather than paid at checkout, and every parcel ships white-labelled by default: no Lucent branding, no invoices in the box, and no confirmation email to your customer from us. Your customer is your customer.

Base URL

https://lucentimaging.com.au/api/print/v1

Everything is JSON over HTTPS, authenticated with a bearer key. There is no SDK to install.

How an order flows

STEP 1

Upload the artwork

POST /uploads returns a signed URL. Put the file there, then reference the URL it gives back on a quote line.

STEP 2

Price the basket

POST /quotes runs the same pricing engine as our own storefront and holds the result for 24 hours.

STEP 3

Place the order

POST /orders turns a held quote into a job. The quote is the price - we never re-price at submission.

STEP 4

Follow it

Poll the order, or register a webhook and we will tell you when it moves, ships and completes.

Before you start

You need a Lucent trade account and an API key, both issued by the studio - there is no self-serve signup. Every key is minted against one account, carries a fixed set of scopes, and belongs to either the live or the test environment.

Test keys run the identical code path and price identically. The orders they create are never printed, never invoiced for real and never reach the studio floor, so you can build the whole integration against production behaviour before anything is made.

What to read next

The quickstart walks a first order end to end. Conventions covers how we represent amounts, identifiers and dates, and - importantly - which changes we may make to this API without warning, so your integration keeps working. The reference documents every endpoint field by field.