How do I retrieve a job output?


API method

Retrieve a completed job by polling the GET /v5/tool_jobs/:uid endpoint. The UID is the unique ID of the object you want to retrieve.

fetch(`https://api.bannerbear.com/v5/tool_jobs/${UID}`, {
  method: 'GET',
  headers: {
    'Authorization' : `Bearer ${API_KEY}`
  }
}) 

This endpoint polls the status and outputs of a tool run. Once status is completed , the finished file URLs are available under outputs.

The shape of the outputs object depends on which tool created the job — refer to that tool's endpoint for the concrete keys.

Webhook method

Consider creating a webhook to be notified when an asset has been created.

Start a Free Trial

Start a free trial with 30 API credits, no credit card required

Resize Video
Add Intro Animation
Add Subtitles

Get Started for Free