Get visual request status
GET/v1/visual/:request-id/status
Retrieve the current status and details of a visual request.
The status can be:
- pending: Request is queued for processing
- completed: Processing finished successfully, files are available
- failed: Processing failed due to an error
When status is "completed", the response includes generated_files array with download links and metadata.
Important: Both status and file URLs expire after 30 minutes from generation.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 410
- 429
- 500
- 503
Request status retrieved successfully
A path parameter is not the identifier form the route expects
The bearer token was accepted once and is no longer usable. Mint or refresh a token; retrying the same one never succeeds.
No usable credential was sent, the credential is not one this API accepts, the grant lacks the scope, or the resource belongs to another caller.
The request does not exist
The request completed too long ago to still be readable. Its files are gone; create a new request.
Repeated bad credentials from this address are being refused. This endpoint is not rate limited, so this is the only 429 it answers, and it carries no Retry-After, no rate limit headers and none of the window fields a rate limit refusal adds.
The call failed on our side and may be retried
A dependency is down or slow: the database, the queue, or the storage a download reads from. The call may be retried with backoff. A download answering this has not lost the file; storage could not be read.