---
title: "List Variables"
method: GET
path: "/v1/projects/{project}/variables"
tags: ["Variables"]
---

# List Variables

`GET /v1/projects/{project}/variables`

## Path parameters

- `project` string, required

## Query parameters

- `page` number
- `perPage` number
- `sortBy` 'createdAt' | 'updatedAt' | 'name' | 'key' | 'propertyKey'
- `sortOrder` 'asc' | 'desc'
- `search` string
- `feature` string
- `type` 'String' | 'Boolean' | 'Number' | 'JSON'
- `status` 'active' | 'archived'

## Response `200`

- Variable[]
  - `name` string — Variable name
  - `description` string — A description of the Variable
  - `key` string, required — Unique Variable identifier, can be used in the SDK / API to reference by key rather then ID. Must only contain lower-case characters and `_`, `-` or `.`.
  - `_id` string, required — A unique Variable ID
  - `_project` string, required — The ID of the Project this Variable belongs to
  - `_feature` string — The ID of the Feature this Variable belongs to
  - `type` 'String' | 'Boolean' | 'Number' | 'JSON', required — The type of Variable. Must be one of [String | Boolean | Number | JSON]
  - `status` 'active' | 'archived', required — The status of a Variable. Must be one of [active | archived]
  - `source` 'api' | 'dashboard' | 'importer' | 'github.code_usages' | 'github.pr_insights' | 'gitlab.code_usages' | 'gitlab.pr_insights' | 'bitbucket.code_usages' | 'bitbucket.pr_insights' | 'terraform' | 'cli' | 'slack' | 'mcp', required — The system that was used for the creation of the Variable.
  - `_createdBy` string — ID of the User who created the Variable.
  - `createdAt` string, date-time, required — The date the Variable was created
  - `updatedAt` string, date-time, required — The date the Variable was last updated
  - `validationSchema` VariableValidationEntity
    - `schemaType` object, required
    - `enumValues` object
    - `regexPattern` string
    - `jsonSchema` string
    - `description` string, required
    - `exampleValue` object, required
  - `persistent` boolean — Boolean indicating if the variable is intended to be long-lived within a feature
  - `tags` string[] — Tags to organize Variables on the dashboard

## Other responses

- `400`
- `401`
- `403`
- `404`

---

[API](https://skmtc.dev/devcycle/apis/devcycle-management-api.md) · [All operations](https://skmtc.dev/devcycle/apis/devcycle-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/devcycle/devcycle-management-api/revisions/d4a127a37608/schema)