Skip to main content
GET
Get a delivery download link

Path Parameters

id
string
required

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.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{21,22}$
Example:

"7Kq2mVn8pRt3XwYz5Bd4L"

orderItemId
string
required

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.

Pattern: ^[1-9A-HJ-NP-Za-km-z]{21,22}$
Example:

"7Kq2mVn8pRt3XwYz5Bd4L"

Response

A presigned download URL, valid for expiresIn seconds.

A short-lived link to a file delivered with a completed order item.

url
string
required

Presigned download URL. Single delivery, short-lived, and safe to hand straight to the browser — do not cache or re-share it.

Example:

"https://files.taberna.io/deliveries/9f2k...?X-Amz-Expires=300"

fileName
string
required

Suggested filename for the download.

Example:

"guide.pdf"

expiresIn
integer
required

Seconds the url stays valid for.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

300