## List

`BranchListPage projects().branches().list(BranchListParamsparams = BranchListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`

**get** `/v0/projects/{project}/branches`

Retrieve a project branch by name.

### Parameters

- `BranchListParams params`

  - `Optional<String> project`

  - `Optional<String> cursor`

    Pagination cursor from a previous response

  - `Optional<Double> limit`

    Maximum number of items to return, defaults to 10 (maximum: 100).

### Returns

- `class BranchListResponse:`

  A project branch names a line of development for a project. Like a Git
  branch, it points to a Git commit with a set of config files. In addition, a
  project branch also points to a set of custom code changes, corresponding to
  Git branches in the staging repos.

  - `String branch`

    Branch name

  - `ConfigCommit configCommit`

    A Git commit that points to the latest set of config files on a given
    branch.

    - `Repo repo`

      - `String branch`

      - `String name`

      - `String owner`

    - `String sha`

  - `String latestBuildId`

  - `Object object_`

    - `PROJECT_BRANCH("project_branch")`

  - `String org`

  - `String project`

    Project name

### Example

```java
package com.stainless.api.example;

import com.stainless.api.client.StainlessClient;
import com.stainless.api.client.okhttp.StainlessOkHttpClient;
import com.stainless.api.models.projects.branches.BranchListPage;
import com.stainless.api.models.projects.branches.BranchListParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        StainlessClient client = StainlessOkHttpClient.fromEnv();

        BranchListPage page = client.projects().branches().list();
    }
}
```