---
title: "Get environment variable"
method: GET
path: "/v2/actors/{actorId}/versions/{versionNumber}/env-vars/{envVarName}"
tags: ["Actors/Actor versions"]
---

# Get environment variable

`GET /v2/actors/{actorId}/versions/{versionNumber}/env-vars/{envVarName}`

Gets a [EnvVar object](#/reference/actors/environment-variable-object) that
contains all the details about a specific environment variable of an Actor.

If `isSecret` is set to `true`, then `value` will never be returned.

## Path parameters

- `actorId` string, required
- `versionNumber` string, required
- `envVarName` string, required

## Response `200`

- EnvVarResponse
  - `data` EnvVar, required
    - `name` string, required — The name of the environment variable.
    - `value` string — The value of the environment variable. If `isSecret` is `true`, this value isn't returned by the API.
    - `isSecret` boolean, nullable — Whether the environment variable is encrypted. Secret values aren't returned by the API.

## Other responses

- `400` — Bad request - invalid input parameters or request body.
- `401` — Unauthorized - authentication required or invalid token.
- `403` — Forbidden - insufficient permissions to perform this action.
- `404` — Not found - the requested resource does not exist.
- `405` — Method not allowed.
- `429` — Too many requests - rate limit exceeded.

## Changes

- **2026-08-28** `0a98d6a098a4` — 6 warning
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `400`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `401`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `403`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `404`
  - …2 more
- **2026-07-31** `5ceb2cdfe616` — 1 info
  - api operation id `act_version_envVar_get` removed and replaced with `actor_version_envVar_get`
- **2026-07-26** `b94a8abdfff1` — 6 warning
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `400`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `401`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `403`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `404`
  - …2 more

[Change history](https://skmtc.dev/apify/apis/apify-api/changes/v2/actors/:actorId/versions/:versionNumber/env-vars/:envVarName/get.md)

---

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