---
title: "Get one layer"
method: GET
path: "/console/v1/layers/{id}"
tags: ["Layers"]
---

# Get one layer

`GET /console/v1/layers/{id}`

## Path parameters

- `id` string, required

## Response `200`

Get one layer response

- object
  - `message` string, required — A simple string explaining the result of the operation.
  - `data` object, required — A single result.
    - `id` string, required — ID
    - `name` string — Optional name for the configuration.
    - `idType` string, required — The ID type used for this layer, important for validation.
    - `description` string, required — A detailed description of the layer, explaining its purpose and functionality.
    - `lastModifierID` string, nullable, required — ID of the last modifier.
    - `lastModifiedTime` number, double, nullable, required — Time of the last modification.
    - `lastModifierEmail` string, nullable, required — Email of the last modifier.
    - `lastModifierName` string, nullable, required — Name of the last modifier.
    - `creatorID` string, nullable, required — ID of the user who created the entity.
    - `createdTime` number, double, required — Timestamp when the entity was created.
    - `creatorName` string, nullable, required — Name of the creator.
    - `creatorEmail` string, nullable, required — Email of the creator.
    - `tags` string[] — Optional tags for categorization.
    - `targetApps` union — List of target applications that this layer is intended for.
      - string
      - string[]
    - `holdoutIDs` string[] — Holdouts applied to this configuration.
    - `team` string, nullable — Optional name for the responsible team.
    - `teamID` string, nullable — Optional ID of the responsible team.
    - `version` number, double — Version number
    - `isImplicitLayer` boolean, required — Indicates if the layer was automatically created by Statsig during experiment creation.
    - `parameters` object[], required — An array of parameters associated with the layer, each defining specific attributes.
      - `name` string, required — The name of this parameter, used for identification within the layer.
      - `type` 'string' | 'number' | 'boolean' | 'object' | 'array', required — The data type that this parameter returns. Allowed types include: string, boolean, number, object, and array.
      - `defaultValue` union, required — The default value for this parameter, which must match the specified type.
        - string
        - number
        - boolean
        - object
        - union[]
          - union
            - string
            - number
            - boolean
            - object
      - `description` string — An optional helpful description of what this layer parameter does, providing context for its purpose.
      - `schema` string, nullable — Optional JSON schema for object parameters. If provided, defaultValue must satisfy the schema.
    - `targeting_gate_parameter_values` object[], required — Parameter values returned when a targeting gate passes during ship-with-targeting.
      - `targetingGateName` string, required — The name of the targeting gate for these shipped values.
      - `parameters` object, required — Layer parameter values returned when the targeting gate passes.
    - `holdout_parameter_values` object[], required — Holdout-specific parameter values for this layer.
      - `holdoutID` string, required — The ID of the holdout for these layer parameter values.
      - `parameters` object, required — Layer parameter values returned when the holdout gate passes.
      - `excludeNewParams` boolean, required — Whether newly added layer parameters should be excluded from this holdout edge.
    - `permalink` string, uri, required — A permalink to this layer in the Statsig Console.

## Other responses

- `400` — Invalid request. Please check the request input and try again.
- `401` — This endpoint only accepts an active CONSOLE key, but an invalid key was sent. Key: console-xxxXXXxxxXXXxxx
- `404` — Not Found. The requested resource could not be found.

---

[API](https://skmtc.net/statsig/apis/console-api.md) · [All operations](https://skmtc.net/statsig/apis/console-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/statsig/console-api/versions/3189f450c93b/schema)
