The Print Lab API connects your lab's software to the albums photographers send you through Spreadu.
Photographers design their albums in Spreadu and send them to your lab. The Print Lab API lets your own software pick them up from there: find new albums, download the production files, check that every byte arrived, tell Spreadu you have them and confirm your order. No more downloading files by hand or copying order numbers between tabs.
If you can send an HTTP request, you can build this. Desktop apps, WordPress plugins and in-house tools all use the same API.
Start in Test mode, no risk involved
Test mode gives your lab its own playground of generated albums. Nothing you do there touches a photographer's album. Open Lab Portal → Lab settings → API, switch to Test, create a key and follow Test your integration. Your first export takes about ten minutes.
A photographer sends an album. Spreadu prepares the production files in the background and tells you when they are ready, with an event or a webhook.
You download and check the files. Ask for download links, save every file and compare its checksum. See Find and download exports.
You say "got it". Record a receipt, and Spreadu shows that the files arrived safely. See Receipts, orders and locks.
You confirm the order. Confirmation attaches your order number and locks the album, so nothing changes under your feet while you print.
And when the photographer spots a typo the night before? They submit a correction, you get an event, and the new revision arrives the same way. The old one is clearly marked as withdrawn, so you never print the wrong version.
The API lives at https://api.spreadu.com/api/print-lab/v1, for test keys and
live keys alike. The interactive
API reference lists every
operation, field and error, and the
OpenAPI document
generates a typed client in your language of choice.
Your first export in ten minutes, test scenarios and the road to live access.
Create keys, pick scopes and keep them safe.
List albums, read the export summary and download every file.
Tell Spreadu you have the files, confirm orders and lock albums.
The event feed: a numbered list of everything that happened.
Get a signed message the moment something changes.
Let your integration set up its own webhook endpoints.
Play photographer in Test mode: corrections, withdrawals, expiry.
Complete TypeScript and PHP integrations, Bruno and Postman.
Connect your shop with the tools you already use.
Every error code, the rate limits and what to do when something goes wrong.
How the API evolves and what changed in each version.
Stuck, or missing something your lab needs? Write to [email protected]. This API grows with the labs that use it, and your feedback decides what comes next.
Allow analytics to help us improve these docs? We measure page visits and outgoing links. No session recordings. Privacy policy