## List

`projects.branches.list(**kwargs) -> Page<BranchListResponse>`

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

Retrieve a project branch by name.

### Parameters

- `project: String`

- `cursor: String`

  Pagination cursor from a previous response

- `limit: Float`

  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.

  - `branch: String`

    Branch name

  - `config_commit: { repo, sha}`

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

    - `repo: { branch, name, owner}`

      - `branch: String`

      - `name: String`

      - `owner: String`

    - `sha: String`

  - `latest_build_id: String`

  - `object: :project_branch`

    - `:project_branch`

  - `org: String`

  - `project: String`

    Project name

### Example

```ruby
require "stainless_v0"

stainless = StainlessV0::Client.new(
  api_key: "My API Key",
  environment: "staging" # defaults to "production"
)

page = stainless.projects.branches.list(project: "project")

puts(page)
```