---
title: "Get Collection Render Option"
method: GET
path: "/stac/collections/{collectionId}/configurations/render-options/{renderOptionId}"
tags: ["STAC Collection Configuration"]
---

# Get Collection Render Option

`GET /stac/collections/{collectionId}/configurations/render-options/{renderOptionId}`

Get a render option for a given collection

## Path parameters

- `collectionId` string, required
- `renderOptionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- RenderOption — Defines visualization parameters for rendering data on a map.
  - `id` string, required — Unique identifier for the render option.
  - `name` string, required — Short descriptive name for the render option.
  - `description` string — A longer description of the render option that can be used to explain its content.
  - `type` 'raster-tile' | 'vt-polygon' | 'vt-line' — The type of rendering to apply (raster or vector).
  - `options` string — A URL query-string encoded string of TiTiler rendering options. Valid only for `raster-tile` types. See [Query Parameters](https://developmentseed.org/titiler/endpoints/cog/#description).
  - `vectorOptions` RenderOptionVectorOptions — Defines parameters for vector tile rendering.
    - `tilejsonKey` string, required — Asset key containing the TileJSON URL.
    - `sourceLayer` string, required — Name of the source layer in the vector tiles.
    - `fillColor` string — Fill color for polygon features.
    - `strokeColor` string — Stroke color for line features.
    - `strokeWidth` integer — Width of line strokes in pixels.
    - `filter` string[] — MapBox GL filter expression to filter features.
  - `minZoom` integer — Minimum zoom level at which to display this layer.
  - `legend` RenderOptionLegend — Configuration for generating a data legend.
    - `type` 'continuous' | 'classmap' | 'interval' | 'none' — Legend type to make, one of: `continuous`, `classmap`, `interval` or `none` (note, `none` is a string literal).
    - `labels` string[] — Text labels to display on the legend.
    - `trimStart` integer — The number of items to trim from the start of the legend definition. Used if there are values important for rendering (e.g. nodata) that aren't desirable in the legend.
    - `trimEnd` integer — Number of items to trim from the end of the legend.
    - `scaleFactor` number, float — A factor to multiply interval legend labels by. Useful for scaled rasters whose colormap definitions map to unscaled values, effectively showing legend labels as scaled values.
  - `conditions` RenderOptionCondition[] — A list of property/value conditions that must be in the active mosaic CQL for this render option to be enabled
    - `property` string, required — Property name to check in the active CQL filter.
    - `value` string — Value that the property must equal.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer.md) · [All operations](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/orbital-microsoft-planetarycomputer/versions/42447be18bc5/schema)