---
title: "GET /1/builds"
method: GET
path: "/1/builds"
tags: ["Builds"]
---

# GET /1/builds

`GET /1/builds`

## Query parameters

- `includeUrls` string
- `appId` string, required

## Response `200`

List of build metadata

- BuildListResponse
  - `data` BuildResponseData[]
    - `appId` string, required — Application id for which build is to be uploaded
    - `changeVersion` string — Publisher/Developer internal change version (Ex: Git commit hash, Perforce CL number etc.)
    - `fileDetails` object — The size and name of the build file
    - `label` string — The label for the build
    - `launchCommand` string — The command required to launch the build, including any parameters or flags
    - `method` 'UPLOAD' | 'EXTERNAL' — One of UPLOAD, PULL or EXTERNAL
    - `notes` string — Optional notes about the build for internal usage
    - `buildTags` string[]
    - `runConfiguration` RunConfiguration
      - `hasDrm` boolean — Boolean indicating if the build is protected by DRM
      - `eulaId` string — Identifier for an existing EULA record to be presented to the user at game launch
    - `semanticVersion` string — Semantic version for public display
    - `scheduledRelease` string, date-time, nullable — Build release date in ISO-8601 format
    - `target` 'GEFORCENOW' | 'GAMEREADYSERVICES' | 'GRAPHICS_DELIVERY_NETWORK' | 'UNKNOWN' — Determines how the build will be processed
    - `pipelineId` integer — Pipeline ID for the build
    - `id` string — UUID for this build
    - `createdBy` string — User who created the build
    - `createdTime` string, date-time — The time of the initial upload
    - `modifiedTime` string, date-time — The last time this build was updated
    - `status` string — Current status of the build
    - `url` string — The location of the downloadable build
  - `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-service-production.skmtc.workers.dev/v1/apis/geforcenow/nvidia-build-management-api/revisions/d0283977ba7a/schema)