---
title: "List Function Versions"
method: GET
path: "/v2/nvcf/functions/{functionId}/versions"
tags: ["Function Management"]
---

# List Function Versions

`GET /v2/nvcf/functions/{functionId}/versions`

Lists details of all the versions of the specified function in the authenticated  NVIDIA Cloud Account. Requires either a bearer token or an api-key with  'list_functions' or 'list_functions_details' scopes in the HTTP Authorization  header.

## Path parameters

- `functionId` string, uuid, required

## Response `200`

OK

- ListFunctionsResponse — Response body containing list of functions
  - `functions` FunctionDto[], required — List of functions
    - `id` string, uuid, required — Unique function id
    - `ncaId` string, required — NVIDIA Cloud Account Id
    - `versionId` string, uuid, required — Unique function version id
    - `name` string, required — Function name
    - `status` 'ACTIVE' | 'DEPLOYING' | 'ERROR' | 'INACTIVE' | 'DELETED', required — Function status
    - `inferenceUrl` string, uri — Entrypoint for invoking the container to process requests
    - `ownedByDifferentAccount` boolean — Indicates whether the function is owned by another account. If the account that is being used to lookup functions happens to be authorized to invoke/list this function which is owned by a different account, then this field is set to true and ncaId will contain the id of the account that owns the function. Otherwise, this field is not set as it defaults to false.
    - `inferencePort` integer — Optional port number where the inference listener is running - defaults to 8000 for Triton
    - `containerArgs` string — Args used to launch the container
    - `containerEnvironment` ContainerEnvironmentEntryDto[] — Environment settings used to launch the container
      - `key` string, required — Container environment key
      - `value` string, required — Container environment value
    - `models` ArtifactDto[] — Optional set of models
      - `name` string, required — Artifact name
      - `version` string, required — Artifact version
      - `uri` string, uri, required — Artifact URI
    - `containerImage` string, uri — Optional custom container
    - `apiBodyFormat` 'PREDICT_V2' | 'CUSTOM' — Invocation request body format
    - `helmChart` string, uri — Optional Helm Chart
    - `helmChartServiceName` string — Helm Chart Service Name specified only when helmChart property is specified
    - `healthUri` string, uri, required — Health endpoint for the container or helmChart
    - `createdAt` string, date-time, required — Function creation timestamp
    - `activeInstances` InstanceDto[] — List of active instances for this function.
      - `instanceId` string — Unique id of the instance
      - `functionId` string, uuid — Function executing on the instance
      - `functionVersionId` string, uuid — Function version executing on the instance
      - `instanceType` string — GPU instance-type powering the instance
      - `instanceStatus` 'ACTIVE' | 'ERRORED' | 'PREEMPTED' | 'DELETED' — Instance status
      - `sisRequestId` string, uuid — SIS request-id used to launch this instance
      - `ncaId` string — NVIDIA Cloud Account Id that owns the function running on the instance
      - `gpu` string — GPU name powering the instance
      - `backend` string — Backend where the instance is running
      - `location` string — Location such as zone name or region where the instance is running
      - `instanceCreatedAt` string, date-time — Instance creation timestamp
      - `instanceUpdatedAt` string, date-time — Instance's last updated timestamp
    - `resources` ArtifactDto[] — Optional set of resources.
      - `name` string, required — Artifact name
      - `version` string, required — Artifact version
      - `uri` string, uri, required — Artifact URI
    - `tags` string[] — Optional set of tags. Maximum allowed number of tags per function is 64. Maximum length of each tag is 128 chars.
    - `description` string — Function/version description
    - `health` HealthDto — Data Transfer Object(DTO) representing a function ne
      - `protocol` 'HTTP' | 'gRPC', required — HTTP/gPRC protocol type for health endpoint
      - `uri` string, uri, required — Health endpoint for the container or the helmChart
      - `port` integer, required — Port number where the health listener is running
      - `timeout` string, PnDTnHnMn.nS, required — ISO 8601 duration string in PnDTnHnMn.nS format
      - `expectedStatusCode` integer, required — Expected return status code considered as successful.
    - `functionType` 'DEFAULT' | 'STREAMING', required — Used to indicate a STREAMING function. Defaults to DEFAULT.
    - `secrets` string[] — Optional secret names

---

[API](https://skmtc.dev/brevdev/apis/cloud-functions.md) · [All operations](https://skmtc.dev/brevdev/apis/cloud-functions/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brevdev/cloud-functions/revisions/add37b001ffc/schema)