> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trugen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Vision Session

> Fetch the current state of a Hawkeye vision session — queued, running, or ended.

Get the state of a vision session created via [Start Vision Session](/api-reference/endpoint/visionstart). Each call refreshes from Hawkeye, so you always get the latest status.

For field-by-field detail see [Get Vision Session Status](/docs/agents/vision/session-status).

## Endpoint

```bash theme={null}
GET https://api.trugen.ai/v2/vision/{session_id}
Header: x-api-key: <api-key>
```

## Example

```bash theme={null}
curl --request GET \
  --url https://api.trugen.ai/v2/vision/8f2a1e5b-4c9d-4a3f-9c11-2c07be7d1c22 \
  --header 'x-api-key: YOUR_API_KEY'
```

## Response

```json theme={null}
{
  "session_id": "8f2a1e5b-4c9d-4a3f-9c11-2c07be7d1c22",
  "status": "IN_PROGRESS",
  "livekit_url": "wss://your-livekit-domain.livekit.cloud",
  "participant": "auto",
  "max_duration": 10,
  "elapsed_duration_seconds": 148,
  "modules": [
    "emotion_recognition",
    "eyegaze_tracking",
    "face_count",
    "face_out_of_focus",
    "face_pose_detection"
  ],
  "started_at": "2026-08-11T14:22:03Z",
  "ended_at": ""
}
```

### Status values

| Status        | Meaning                                     |
| ------------- | ------------------------------------------- |
| `IN_QUEUE`    | Session accepted, worker not yet started.   |
| `IN_PROGRESS` | Hawkeye is in the room and analysing video. |
| `COMPLETED`   | Session ended cleanly.                      |
| `FAILED`      | Worker errored — check callback logs.       |
| `CANCELLED`   | Explicitly cancelled.                       |

## Errors

| Status | Meaning                                                  |
| ------ | -------------------------------------------------------- |
| `401`  | Missing or invalid `x-api-key`.                          |
| `404`  | No session with that id exists for the API key you sent. |