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

# Get Optical Video Frames

> Retrieve individual frames from optical video recordings

Returns saved frames from an optical video recording, including frame image UUIDs and file metadata.

<ParamField path="data_id" type="string" required>
  The data entry UUID for the optical video
</ParamField>

## Response

<ResponseField name="video_uuid" type="string">
  UUID of the video
</ResponseField>

<ResponseField name="frames" type="array">
  Saved video frames

  <Expandable title="properties">
    <ResponseField name="image_uuid" type="string">
      UUID of the frame image
    </ResponseField>

    <ResponseField name="processed_file_metadata" type="object">
      File metadata for the processed frame

      <Expandable title="properties">
        <ResponseField name="file_type" type="string">
          Image file type (e.g., `png`)
        </ResponseField>

        <ResponseField name="width" type="integer">
          Frame width in pixels
        </ResponseField>

        <ResponseField name="height" type="integer">
          Frame height in pixels
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```python SDK theme={null}
  from atomscale import Client

  client = Client(api_key="YOUR_API_KEY")
  results = client.get(data_ids="d290f1ee-6c54-4b01-90e6-d701748f0851")
  optical = results[0]  # OpticalResult
  print(optical.snapshot_image_data)
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.atomscale.ai/optical/frame/video_single_frames/d290f1ee-6c54-4b01-90e6-d701748f0851",
      headers={"X-API-KEY": "YOUR_API_KEY"}
  )
  frames_data = response.json()
  ```

  ```bash cURL theme={null}
  curl "https://api.atomscale.ai/optical/frame/video_single_frames/d290f1ee-6c54-4b01-90e6-d701748f0851" \
    -H "X-API-KEY: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "video_uuid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "frames": [
      {
        "image_uuid": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
        "processed_file_metadata": {
          "file_type": "png",
          "width": 1920,
          "height": 1080
        }
      }
    ]
  }
  ```
</ResponseExample>