Tell Spreadu you have the files, confirm your order and keep the album still while you print.
Two small calls close the loop with the photographer. A receipt says "we have the files". A confirmation says "this is our order, and we're producing this exact version". Repeating a receipt, or the same confirmation, changes nothing.
PUT /api/print-lab/v1/exports/{reference}/receipt
Content-Type: application/json
{ "revision": 2 }This tells Spreadu your lab has that revision's files. The key needs
exports:download.
404 REVISION_NOT_FOUND.export.received event. A repeat answers changed: false with the
original receivedAt and sends nothing.Each revision keeps its own receivedAt. The summary's receivedAt refers to
the downloadable revision, so a new revision starts out unreceived.
Photographers working in your lab editor see "Received by the lab" with the date in the album's export status, and your Lab Portal shows "Received" on the album. A small thing that saves a lot of "did you get my files?" emails.
When your lab is ready to produce an export, confirm the exact revision. The
key needs exports:confirm.
PUT /api/print-lab/v1/exports/{reference}/confirmation
Content-Type: application/json
{
"revision": 2,
"orderNumber": "<your-order-number>",
"externalOrderId": null,
"externalOrderLineId": null
}Send all four fields:
orderNumber is required: 1 to 120 characters after trimming, with no
control characters.externalOrderId and externalOrderLineId are trimmed strings of 1 to 120
characters, or null.Your confirmation can replace a number the photographer entered or an earlier confirmation of yours. When the album has no order details yet, confirmation creates them, without adding a length, copies or a spread count. It never changes an existing length, copies or the album's spreads.
The album must be finalized, and the revision must still be the current,
downloadable one. Otherwise you get 409 REVISION_NOT_DOWNLOADABLE and nothing
changes. Its data.downloadableRevision tells you which revision would work
right now. It's null while the album isn't finalized, for example while the
photographer prepares a new revision.
Confirming the same thing again while the album is locked answers
changed: false and creates no extra event.
Confirmation is not payment
A confirmation identifies your lab's order and protects its production files. It isn't a print confirmation, and it creates no billing records or payments.
Confirmation sets lockedAt. While it's set, the photographer can't:
They can still view the album and use the downloads they're allowed. Expiry, unavailable files, a revoked key and switched-off API access don't release the lock. If a photographer asks why their album is read-only, this lock is the reason, and unlocking it is your lab's call.
DELETE /api/print-lab/v1/exports/{reference}/lockThe key needs exports:confirm. A lab owner, manager or Spreadu admin can also
unlock from the album in the Lab Portal, with their own session. An album
that's already unlocked answers changed: false.
Unlocking keeps the order identifiers and where they came from.
labOrder.confirmedByLab tells you whether that source is API. To know
whether editing is locked, look at lockedAt, not at that field.
Allow analytics to help us improve these docs? We measure page visits and outgoing links. No session recordings. Privacy policy