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

# Get Shading Scene Viewer

> Get a read-optimized 3D viewer payload for a shading scene

# GET /shadingscenes/{scene_id}/viewer

Retrieve a read-optimized payload designed for rendering a shading scene in a 3D viewer. This endpoint returns pre-processed geometry, obstruction, and shading data structured for direct consumption by visualization clients.

## Notes

* This is a **read-optimized** endpoint tailored for 3D rendering, not a general-purpose scene retrieval. Use [GET /shadingscenes/{scene_id}](/api-reference/endpoints/shading-scenes-get) for the full scene record.
* Query parameters control which data layers are included:
  * `include_geometry` (default `true`) — table and module geometry.
  * `include_obstructions` (default `true`) — obstruction mesh data.
  * `include_shading` (default `true`) — shading simulation overlay data.
* `aggregate` controls the shading aggregation level: `"table"` (default) for per-table factors or `"scene"` for whole-scene averages.
* `azimuth_bin` and `elevation_bin` optionally filter shading data to a specific sun position bin.
* Returns `404` if the scene does not exist.
* The response payload is sanitized for safe client consumption and may be large depending on scene complexity.