---
title: "Get version"
method: GET
path: "/v2/actors/{actorId}/versions/{versionNumber}"
tags: ["Actors/Actor versions"]
---

# Get version

`GET /v2/actors/{actorId}/versions/{versionNumber}`

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

## Path parameters

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

## Response `200`

- VersionResponse
  - `data` Version, required
    - `versionNumber` string, required — The version number of the Actor. Two numbers separated by a dot, that represent the `MAJOR.MINOR` part of the semantic versioning.
    - `sourceType` 'SOURCE_FILES' | 'GIT_REPO' | 'TARBALL' | 'GITHUB_GIST' | 'SOURCE_CODE', required
    - `envVars` EnvVar[], nullable — Environment variables for the version.
      - `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.
    - `applyEnvVarsToBuild` boolean, nullable — Whether to inject the environment variables at build time.
    - `buildTag` string, nullable — The tag name to apply to a successful build of this version. Can be `null` when the version has no build tag.
    - `sourceFiles` union[]
      - union
        - SourceCodeFile — Represents a single file in the Actor's source code.
          - `format` 'BASE64' | 'TEXT'
          - `content` string — The contents of the file. Interpreted based on the value of `format`.
          - `name` string, required — The path of the file relative to the Actor's root directory.
        - SourceCodeFolder — Represents a folder in the Actor's source code structure. Distinguished from SourceCodeFile by the presence of the `folder` property set to `true`.
          - `name` string, required — The path of the folder relative to the Actor's root directory.
          - `folder` boolean, required — Whether it's a folder. Distinguishes folders from files.
    - `gitRepoUrl` string, nullable — URL of the Git repository to clone the source code from. Applies when the `sourceType` is `GIT_REPO`.
    - `tarballUrl` string, nullable — URL to download the source code from as a tarball or ZIP file. Applies when the `sourceType` is `TARBALL`.
    - `gitHubGistUrl` string, nullable — URL of the GitHub Gist to clone the source code from. Applies when the `sourceType` is `GITHUB_GIST`.

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

---

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