Polling and webhooks
Two ways to find out a job has finished. Both end with you reading the job once.
Polling
Ask for the job every second or two until its status leaves queued and processing. A typical video is done inside fifteen seconds, so this is perfectly reasonable for a handful of videos and for anything you are debugging by hand.
429. For a batch, poll the batch’s counts rather than each job.Webhooks
Register an endpoint and we post to it when a job reaches done or failed. The event carries the job ID and status, not the rows — fetch the job to collect those, which keeps the read-once rule in one place and means a leaked webhook body contains no extracted data.
Set one up on the webhooks screen. Payload shape and signing are in webhook payloads.
Which to use
You are submitting a few videos inside a request you are already waiting on, or you have nowhere public to receive a callback.
You are running batches of hundreds, or the work that consumes the rows is a background job anyway.