Skip to content

GET /v1/render-outputs/{id}

Download a previously rendered document. The URL is provided in the response from POST /v1/render when using URL delivery.

Endpoint:

GET /v1/render-outputs/{id}
ParameterTypeDescription
idstringThe render job ID (UUID) from the render response.

Requires the same API key (or session token) used to create the render.

Authorization: Bearer bp_sk_live_YOUR_KEY

Status: 200 OK

The response body contains the rendered document. The Content-Type header matches the format:

FormatContent-Type
PDFapplication/pdf
PNGimage/png
ZPLtext/plain
HTMLtext/html

Cache: private, max-age=3600

Terminal window
curl -H "Authorization: Bearer bp_sk_live_YOUR_KEY" \
"https://api.binderypress.dev/v1/render-outputs/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
-o output.pdf
StatusCodeCause
401AUTH_REQUIREDMissing or invalid API key.
404NOT_FOUNDJob ID not found or output has expired (older than 7 days).