---
title: "Lists all Shared Environment Variables for a team"
method: GET
path: "/v1/env"
tags: ["environment"]
---

# Lists all Shared Environment Variables for a team

`GET /v1/env`

Lists all Shared Environment Variables for a team, taking into account optional filters.

## Query parameters

- `search` string
- `projectId` string — Filter SharedEnvVariables that belong to a project
- `ids` string — Filter SharedEnvVariables based on comma separated ids
- `exclude_ids` string — Filter SharedEnvVariables based on comma separated ids
- `'exclude-ids'` string — Filter SharedEnvVariables based on comma separated ids
- `exclude_projectId` string — Filter SharedEnvVariables that belong to a project
- `'exclude-projectId'` string — Filter SharedEnvVariables that belong to a project
- `teamId` string
- `slug` string

## Response `200`

- object
  - `data` object[], required
    - `created` string, date-time — The date when the Shared Env Var was created.
    - `key` string — The name of the Shared Env Var.
    - `ownerId` string, nullable — The unique identifier of the owner (team) the Shared Env Var was created for.
    - `id` string — The unique identifier of the Shared Env Var.
    - `createdBy` string, nullable — The unique identifier of the user who created the Shared Env Var.
    - `deletedBy` string, nullable — The unique identifier of the user who deleted the Shared Env Var.
    - `updatedBy` string, nullable — The unique identifier of the user who last updated the Shared Env Var.
    - `createdAt` number — Timestamp for when the Shared Env Var was created.
    - `deletedAt` number — Timestamp for when the Shared Env Var was (soft) deleted.
    - `updatedAt` number — Timestamp for when the Shared Env Var was last updated.
    - `value` string — The value of the Shared Env Var.
    - `projectId` string[] — The unique identifiers of the projects which the Shared Env Var is linked to.
    - `type` 'encrypted' | 'plain' | 'sensitive' | 'system' — The type of this cosmos doc instance, if blank, assume secret.
    - `target` string[] — environments this env variable targets
    - `applyToAllCustomEnvironments` false | true — whether or not this env varible applies to custom environments
    - `customEnvironmentIds` string[] — The custom environment IDs that this Shared Env Var is scoped to.
    - `decrypted` false | true — whether or not this env variable is decrypted
    - `comment` string — A user provided comment that describes what this Shared Env Var is for.
    - `lastEditedByDisplayName` string — The last editor full name or username.
  - `pagination` Pagination, required — This object contains information related to the pagination of the current request, including the necessary parameters to get the next or previous page of data.
    - `count` number, required — Amount of items in the current page.
    - `next` number, nullable, required — Timestamp that must be used to request the next page.
    - `prev` number, nullable, required — Timestamp that must be used to request the previous page.

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`

---

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