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}

Path Parameter

Parameter	Type	Description
id	string	The render job ID (UUID) from the render response.

Authentication

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

Authorization: Bearer bp_sk_live_YOUR_KEY

Response

Status: 200 OK

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

Format	Content-Type
PDF	application/pdf
PNG	image/png
ZPL	text/plain
HTML	text/html

Cache: private, max-age=3600

Example

curl -H "Authorization: Bearer bp_sk_live_YOUR_KEY" \
  "https://api.binderypress.dev/v1/render-outputs/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -o output.pdf

Errors

Status	Code	Cause
401	AUTH_REQUIRED	Missing or invalid API key.
404	NOT_FOUND	Job ID not found or output has expired (older than 7 days).