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

# Get list of versions

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

Gets the list of versions of a specific Actor. The response is a JSON object
with the list of [Version objects](#/reference/actors/version-object), where each
contains basic information about a single version.

## Path parameters

- `actorId` string, required

## Response `200`

- ListOfVersionsResponse
  - `data` ListOfVersions, required
    - `total` integer, required
    - `items` 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)