---
title: "List all branches"
method: GET
path: "/organizations/{organizationID}/projects/{projectID}/branches"
tags: ["Branches"]
---

# List all branches

`GET /organizations/{organizationID}/projects/{projectID}/branches`

Retrieves a list of all branches within the specified project, including their metadata, region, and access settings.

## Path parameters

- `organizationID` string, required
- `projectID` string, required

## Response `200`

List of branches within the project

- object
  - `branches` BranchListMetadata[], required — Array of branch objects with their metadata
    - `id` string, required — Unique identifier for the branch
    - `name` string, required — Human-readable name of the branch
    - `description` string — Optional description of the branch purpose or contents
    - `createdAt` string, date-time, required — Timestamp when the branch was created
    - `updatedAt` string, date-time, required — Timestamp when the branch was last updated
    - `parentID` string, nullable — Identifier of the parent branch if this is a derived branch, null otherwise
    - `region` string, required — Geographic region where the branch is deployed
    - `publicAccess` boolean, required — Whether the branch allows public access without authentication
    - `backupsEnabled` boolean, required — Whether the branch is in a region that supports backups

## Other responses

- `400` — Generic error response for most error conditions
- `401` — Error response when authentication or authorization fails
- `404` — Generic error response for most error conditions
- `5XX` — Unexpected Error
- `default` — Unexpected Error

---

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