---
title: "List project branches"
method: GET
path: "/v0/projects/{project}/branches"
---

# List project branches

`GET /v0/projects/{project}/branches`

Retrieve a project branch by name.

## Path parameters

- `project` string, required

## Query parameters

- `cursor` string — Pagination cursor from a previous response
- `limit` number — Maximum number of items to return, defaults to 10 (maximum: 100).

## Response `200`

success

- object
  - `data` ProjectBranchMinimal[], required
    - `object` 'project_branch', required
    - `branch` string, required — Branch name
    - `org` string, required
    - `project` string, required — Project name
    - `config_commit` object, required — A Git commit that points to the latest set of config files on a given branch.
      - `sha` string, required
      - `repo` object, required
        - `owner` string, required
        - `name` string, required
        - `branch` string, required
      - `tree_oid` string, nullable, required
      - `stats` object, nullable, required
        - `additions` integer, required
        - `deletions` integer, required
        - `total` integer, required
    - `latest_build_id` string, required
  - `has_more` boolean, required
  - `next_cursor` string

---

[API](https://skmtc.net/stainless-api/apis/my-api.md) · [All operations](https://skmtc.net/stainless-api/apis/my-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stainless-api/my-api/versions/1d73a351f557/schema)