---
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

## Changes

- **2026-02-21** `c05bce23f6a3` — 1 breaking, 2 info
  - the response property `data/items/config_commit/tree_oid` became nullable for the status `200`
  - the response property `data/items/config_commit/tree_oid` became required for the status `200`
  - added the required property `data/items/config_commit/stats` to the response with the `200` status
- **2026-02-20** `bced6b6177fa` — 2 breaking
  - the response property `data/items/config_commit/tree_oid` became optional for the status `200`
  - removed the required property `data/items/config_commit/stats` from the response with the `200` status
- **2026-02-20** `c05bce23f6a3` — 1 breaking, 2 info
  - the response property `data/items/config_commit/tree_oid` became nullable for the status `200`
  - the response property `data/items/config_commit/tree_oid` became required for the status `200`
  - added the required property `data/items/config_commit/stats` to the response with the `200` status
- **2026-02-17** `acfed4185515` — 1 info
  - added the optional property `data/items/config_commit/tree_oid` to the response with the `200` status
- **2025-08-12** `c9dbcee416d3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stainless-api/apis/my-api/changes/v0/projects/:project/branches/get.md)

---

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