---
title: "Get Config"
method: GET
path: "/stac/collections/{collectionId}/configurations"
tags: ["STAC Collection Configuration"]
---

# Get Config

`GET /stac/collections/{collectionId}/configurations`

Get the complete user configuration for a given collection

## Path parameters

- `collectionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- UserCollectionSettings — User-specific collection settings for visualization.
  - `tileSettings` TileSettings, required — Configuration for map tile visualization.
    - `minZoom` integer, required — The minimum zoom level that can be requested for this collection. Provides a hard limit for the tile servers to ensure they don't get requests for low zoom levels, which would cause many files to be fetched and the tile servers to hang.
    - `maxItemsPerTile` integer, required — Maximum number of items to include in a single tile.
    - `defaultLocation` DefaultLocation — Defines a default geographic location for map visualization.
      - `zoom` integer, required — Default zoom level for the map.
      - `coordinates` number[], required — Default center coordinates [latitude, longitude] for the map.
  - `mosaicInfo` StacMosaicConfiguration, required — Configuration for data mosaic visualization.
    - `mosaics` StacMosaic[], required — Predefined data mosaics available for this collection.
      - `id` string, required — Unique identifier for the mosaic.
      - `name` string, required — Short descriptive name for the mosaic.
      - `description` string — Detailed description of the mosaic.
      - `cql` object[], required — A list of valid CQL2-JSON expressions used to filter the collection to moasic.
    - `renderOptions` RenderOption[], required — Available render options for visualizing the data.
      - `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.
    - `defaultLocation` DefaultLocation — Defines a default geographic location for map visualization.
      - `zoom` integer, required — Default zoom level for the map.
      - `coordinates` number[], required — Default center coordinates [latitude, longitude] for the map.
    - `defaultCustomQuery` object — A list of CQL-JSON expressions to use as the default for this collection.

## 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)