GET /v1/{job_id}
Read job results with GET /v1/{job_id}: job status, each video's status and its extracted rows once every video has settled. Results are handed over once.
Request
No body. The key must belong to the workspace that created the job; anything else returns 404, including an id that does not exist — this endpoint never confirms that someone else’s job is real.
Response
videos lists every video in the job, each with its own status. rows stays null until every video in the job has settled. Poll status or counts to watch progress; polling never consumes anything.
status is done when every video succeeded, failed when every one failed, and partial when it was a mix. A failed video carries an error and is never charged. A video’s rows is an array when the schema has multiple: true, and a single object otherwise.
Results are returned once
The first read that finds the job settled returns the rows and deletes them here, along with the URLs you submitted. A later read returns the same envelope with rows: null and url: null on every video.
Reads while the job is still running are safe: nothing is handed over, so nothing is deleted. The handover happens on one read and one only — the first one that finds nothing left queued or processing.