Get a delivery download link
Mints a short-lived presigned URL for a file delivered with a completed order item.
Every failure — unknown checkout, order not completed, wrong item, a delivery that is not a file, an invoice id — answers with the same 404 and the same message, so the endpoint never reveals which check failed.
Unauthenticated: possession of the checkout id is the credential, so send no API key. The id is unguessable and every payload is redacted for a buyer audience.
Path Parameters
The completed order the file belongs to. Base58 short id, 21–22 characters (never 0, O, I or l), e.g. 7Kq2mVn8pRt3XwYz5Bd4L — the value that appears in checkout and invoice links, and the one this API takes as a path id.
^[1-9A-HJ-NP-Za-km-z]{21,22}$"7Kq2mVn8pRt3XwYz5Bd4L"
The order item to download, taken from that item's delivery.orderItemId. Base58 short id, 21–22 characters (never 0, O, I or l), e.g. 7Kq2mVn8pRt3XwYz5Bd4L — the value that appears in checkout and invoice links, and the one this API takes as a path id.
^[1-9A-HJ-NP-Za-km-z]{21,22}$"7Kq2mVn8pRt3XwYz5Bd4L"
Response
A presigned download URL, valid for expiresIn seconds.
A short-lived link to a file delivered with a completed order item.
Presigned download URL. Single delivery, short-lived, and safe to hand straight to the browser — do not cache or re-share it.
"https://files.taberna.io/deliveries/9f2k...?X-Amz-Expires=300"
Suggested filename for the download.
"guide.pdf"
Seconds the url stays valid for.
-9007199254740991 <= x <= 9007199254740991300