---
title: "GET /1/gfn-build-versions"
method: GET
path: "/1/gfn-build-versions"
tags: ["Build Versions"]
---

# GET /1/gfn-build-versions

`GET /1/gfn-build-versions`

## Request

- Base URL: `https://developer.geforcenow.com/api`
- URL: `https://developer.geforcenow.com/api/1/gfn-build-versions`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/geforcenow/apis/nvidia-build-management-api/docs/1/gfn-build-versions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Success

- BuildVersionsResponseModel
  - `data` BuildVersionModel[]
    - `versionId` string: Identifier of the games version
    - `developerVersion` string: Identifier of the games version that is assigned by the developer
    - `platformDetailsId` string: Identifier for the platform details if the version is provided through chroma pull model
    - `patchId` string: Identifier for the patch
    - `source` 'UNKNOWN' | 'GPDS' | 'CHROMA' | 'GFNAP_DEVELOPER' | 'ONBOARDING' | 'CHROMA_ONBOARDING': The source from which the version is delivered
    - `versionStatus` 'UNKNOWN' | 'LIVE' | 'NOT_LIVE': The status of the version
    - `versionCreationDateTime` string, date-time: Date/time in UTC in ISO 8601 format which shows the date time that the version created
    - `releaseDateTime` string, date-time: Date/time in UTC in ISO 8601 format which shows the date time that the version is released publicly
    - `prerelease` boolean: Flag indicating whether the build version is pre-released or not
    - `buildDetailsAvailable` boolean: Flag indicating whether details of uploaded/platform build is available in chroma
  - `related` BuildVersionRelatedModel
    - `versionDetails` BuildVersionDetailsModel[]
      - `versionId` string: Identifier of the games version
      - `createdByDisplayName` string: Email of the user who has created the build version
      - `notes` string: Optional notes about the build for internal usage
      - `label` string: User friendly readable label of the build assigned at the time of upload
      - `evictionSetting` 'UNKNOWN' | 'EVICTION_POLICY' | 'NEVER_EVICT': Eviction setting of a build version
      - `buildTags` string[]
      - `semanticVersion` string: Semantic version for public display
      - `launchCommand` string: Command needed to launch the title build
    - `zoneDetails` BuildVersionAppZoneModel[]
      - `versionId` string: Identifier of the games version
      - `zones` BuildVersionZoneModel[]
        - `zoneName` string: Name of the zone
        - `available` boolean: Flag indicating if the build version is available in the zone
  - `paging` Pagination
    - `total` integer: Total number of objects
    - `offset` integer: Starting point within the list of objects
    - `limit` integer: Number of the returned objects for the given request
    - `nextOffset` integer: Starting point of the next list of objects
    - `previousOffset` integer: Starting point of the previous list of objects

## Other responses

- `401`: Invalid or expired token presented

---

[API](https://skmtc.dev/geforcenow/apis/nvidia-build-management-api.md) - [All operations](https://skmtc.dev/geforcenow/apis/nvidia-build-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/geforcenow/apis/nvidia-build-management-api/revisions/d0283977ba7a?raw)