---
title: "GET /apps/{appId}/branches"
method: GET
path: "/apps/{appId}/branches"
---

# GET /apps/{appId}/branches

`GET /apps/{appId}/branches`

Lists the branches of an Amplify app.

## Path parameters

- `appId` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListBranchesResult — The result structure for the list branches request.
  - `branches` Branch[], required — A list of branches for an Amplify app.
    - `branchArn` string, required — The Amazon Resource Name (ARN) for a branch that is part of an Amplify app.
    - `branchName` string, required — The name for the branch that is part of an Amplify app.
    - `description` string, required — The description for the branch that is part of an Amplify app.
    - `tags` object — The tag for the branch of an Amplify app.
    - `stage` 'PRODUCTION' | 'BETA' | 'DEVELOPMENT' | 'EXPERIMENTAL' | 'PULL_REQUEST', required — The current stage for the branch that is part of an Amplify app.
    - `displayName` string, required — The display name for the branch. This is used as the default domain prefix.
    - `enableNotification` boolean, required — Enables notifications for a branch that is part of an Amplify app.
    - `createTime` string, date-time, required — The creation date and time for a branch that is part of an Amplify app.
    - `updateTime` string, date-time, required — The last updated date and time for a branch that is part of an Amplify app.
    - `environmentVariables` object, required — The environment variables specific to a branch of an Amplify app.
    - `enableAutoBuild` boolean, required — Enables auto-building on push for a branch of an Amplify app.
    - `customDomains` CustomDomain[], required — The custom domains for a branch of an Amplify app.
    - `framework` string, required — The framework for a branch of an Amplify app.
    - `activeJobId` string, required — The ID of the active job for a branch of an Amplify app.
    - `totalNumberOfJobs` string, required — The total number of jobs that are part of an Amplify app.
    - `enableBasicAuth` boolean, required — Enables basic authorization for a branch of an Amplify app.
    - `enablePerformanceMode` boolean — <p>Enables performance mode for the branch.</p> <p>Performance mode optimizes for faster hosting performance by keeping content cached at the edge for a longer interval. When performance mode is enabled, hosting configuration or code changes can take up to 10 minutes to roll out. </p>
    - `thumbnailUrl` string — The thumbnail URL for the branch of an Amplify app.
    - `basicAuthCredentials` string, password — The basic authorization credentials for a branch of an Amplify app. You must base64-encode the authorization credentials and provide them in the format <code>user:password</code>.
    - `buildSpec` string, password — The build specification (build spec) content for the branch of an Amplify app.
    - `ttl` string, required — The content Time to Live (TTL) for the website in seconds.
    - `associatedResources` AssociatedResource[] — A list of custom resources that are linked to this branch.
    - `enablePullRequestPreview` boolean, required — Enables pull request previews for the branch.
    - `pullRequestEnvironmentName` string — The Amplify environment name for the pull request.
    - `destinationBranch` string — The destination branch if the branch is a pull request branch.
    - `sourceBranch` string — The source branch if the branch is a pull request branch.
    - `backendEnvironmentArn` string — The Amazon Resource Name (ARN) for a backend environment that is part of an Amplify app.
  - `nextToken` string — A pagination token. If a non-null pagination token is returned in a result, pass its value in another request to retrieve more entries.

## Other responses

- `480` — BadRequestException
- `481` — UnauthorizedException
- `482` — InternalFailureException

---

[API](https://skmtc.net/aws/apis/amplify.md) · [All operations](https://skmtc.net/aws/apis/amplify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/amplify/revisions/573daadbd119/schema)