GET /v2/vision/{session_id} returns the current state of a Hawkeye vision session — queued, running, or ended — along with the modules that are active and how long the session has been alive.
Endpoint
session_id is the id returned by Start a Vision Session.
Example
Response
Response fields
Status values
Polling Guidance
The status endpoint refreshes from Hawkeye on every call, so you never need to poll more often than roughly once every few seconds. Once a session reaches a terminal state (COMPLETED, FAILED, CANCELLED), further calls just replay the final response — no extra work is done backend-side.
What’s Next?
Start a Vision Session
Kick off a new session with the modules and classes you need.
Overview
What Vision Understanding does and when to use it.