---
title: "List active project branches"
method: GET
path: "/projects/v1/{project_id}/branches"
tags: ["Project Branches"]
---

# List active project branches

`GET /projects/v1/{project_id}/branches`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/projects/v1/{project_id}/branches`
- Auth: one of:
  - API key in header `SIGN-IN-WITH-X`
  - HTTP bearer

## Path parameters

- `project_id` string, required: Run402 project ID. Public IDs are not UUIDs.

## Response `200`

Active branches.

- ProjectBranchList
  - `branches` ProjectBranch[], required
    - `branch_project_id` string, required: The branch project's Run402 project ID.
    - `parent_project_id` string, required: The parent project's Run402 project ID.
    - `name` string, required
    - `branch_url` string, uri, nullable
    - `subdomain` string, nullable
    - `status` 'active', required
    - `email_mode` 'sandbox' | 'off', required
    - `enable_cron` boolean, required
    - `data_from` object, required
      - `snapshot_id` string, nullable
      - `captured_at` string, date-time, nullable
    - `release` object, required
      - `parent_release_id` string, nullable
      - `branch_release_id` string, nullable
    - `expires_at` string, date-time, required
    - `created_at` string, date-time, required
    - `next_actions` NextAction[], required
      - `type` string, required: Advisory machine-readable action type such as retry, authenticate, submit_payment, fund_wallet, renew_tier, check_usage, resume_deploy, edit_request, edit_migration, contact_support, upgrade_client, poll (poll the project events feed — appended when the envelope carries a correlated_platform_incident), or hand_to_member (on a commit/promote response that just activated a public site: show the human urls.site and urls.console, relay Run402's offer to promote the build on @run402com, and ask yes or no — see `credited_as` below).
      - `method` string
      - `path` string
      - `auth` string
      - `why` string
      - `credited_as` string, nullable: `hand_to_member` only. The caller's own live presence name in the project's default room, else that room's most recently active live presence, else `null` — in which case `why` tells the agent that joining the room with a name (`run402 rooms join --name ...`) is how the promotion credits it.
      - `body` object: `hand_to_member` only. A ready-to-send `POST /feedback/v1` template: `{ project_id, message: "promote: yes", handle? }`.

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)