---
title: "List builds for a 'Custom CI' integration on a release"
method: GET
path: "/app/{appId}/integration/{integrationInstallationId}/build"
tags: ["app"]
---

# List builds for a 'Custom CI' integration on a release

`GET /app/{appId}/integration/{integrationInstallationId}/build`

## Request

- Base URL: `https://api.runway.team`
- URL: `https://api.runway.team/app/{appId}/integration/{integrationInstallationId}/build`
- Auth: API key in header `X-API-Key`

Lists builds uploaded to a Custom CI (Mobile Release Management / MRM) integration for a specific release. Use this to discover the `buildHash` for a build (e.g. to download its artifact). Only supported for integrations of type `customCI` — for other CI providers (Bitrise, CircleCI, etc.) builds are fetched directly from the provider and are not listed here. Results are sorted newest first.

## Path parameters

- `appId` string, required
- `integrationInstallationId` string, required

## Query parameters

- `version` string, required

## Response `200`

List of builds uploaded to the integration for the given release, sorted newest first.

- CIBuildEntity[]
  - `buildHash` string, required: A unique identifier for the build from a CI system, generated from the combination of integrationId and build identifier
  - `buildIdentifier` string, required: The identifier of the build as set by the integration provider
  - `integrationId` 'amazon' | 'apple' | 'google' | 'huawei' | 'samsung' | 'expo-eas' | 'appcenter-beta' | 'apple-beta' | 'google-beta' | 'firebase-beta' | 'runway-build-distro-beta' | 'appcenter-ci' | 'apple-ci' | 'azure-ci' | 'bitrise' | 'buildkite' | 'circleci' | 'codemagic' | 'generic-ci' | 'github-ci' | 'gitlab-ci' | 'jenkins' | 'travis' | 'launchdarkly' | 'optimizely' | 'statsig' | 'firebase-remote-config' | 'amplitude-experiment' | 'unleash' | 'asana' | 'azure-it' | 'jira' | 'linear' | 'pivotal' | 'shortcut' | 'monday' | 'slack' | 'microsoft-teams' | 'amplitude' | 'datadog-analytics' | 'mixpanel-analytics' | 'google-analytics' | 'apple-power-performance-metrics' | 'new-relic-analytics' | 'custom-analytics' | 'testrail' | 'qase' | 'testmo' | 'browserstack' | 'xray' | 'bugsnag' | 'firebase' | 'sentry' | 'embrace-stability-monitoring' | 'datadog-stability-monitoring' | 'dynatrace-stability-monitoring' | 'new-relic-stability-monitoring' | 'luciq-stability-monitoring' | 'luciq-analytics' | 'github-vcs-dist' | 'bitbucket' | 'github' | 'gitlab-vcs' | 'azure-vcs' | 'pagerduty-scheduling' | 'incident-io-scheduling' | 'opsgenie-scheduling' | 'crowdin' | 'lokalise' | 'jira-service-management-scheduling', required: The type of integration
  - `buildUrl` string, required: The URL to the build in the CI system
  - `buildStartedAt` string, date-time, required: The start date and time of the build
  - `buildFinishedAt` string, date-time: The end date and time of the build
  - `buildStatus` 'inProgress' | 'stopped' | 'success' | 'failure' | 'skipped', required: The status of the CI build. When passing build info as part of an artifact upload, this value should always be `success`.
  - `providerBuildStatusString` string: The status string displayed to the user from the provider
  - `commit` string, required: The commit hash that triggered the build
  - `commitMessage` string: The commit message associated with the commit hash that triggered the build
  - `commitAuthor` string: The author of the commit that triggered the build
  - `commitUrl` string: The URL to the commit in the version control system
  - `workflowName` string: The displayable name of the workflow
  - `branchName` string, required: The branch name the build was triggered from
  - `workflowRunIdOrCommaDelimitedIds` string: The workflow run ID(s) associated with this build. Can be a single ID or comma-delimited list of IDs

## Other responses

- `404`: Resource not found response

---

[API](https://skmtc.dev/runway/apis/runway-rest-api.md) - [All operations](https://skmtc.dev/runway/apis/runway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runway/apis/runway-rest-api/revisions/081109863a9a?raw)