List branches

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/branches \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/apps/{app_id}/branches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/branches",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/branches"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/branches")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "68f1a2b3c4d5e6f708192a3b",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "branch_name": "add-contact-form",
    "status": "active",
    "run_state": {
      "state": "ready",
      "details": "Restoring checkpoint",
      "last_updated_date": "2026-09-28T10:18:40"
    },
    "code_state": "changed",
    "base_checkpoint_id": "6886b8d390dc7e2f4a2c91b3",
    "created_by_id": "68a0c1d2e3f4a5b6c7d8e9f0",
    "created_by_name": "Jane Doe",
    "created_date": "2026-09-28T10:15:00",
    "merged_at": "2026-09-29T08:02:11",
    "merged_by_id": "68a0c1d2e3f4a5b6c7d8e9f0",
    "static_preview_url": "https://preview--6820f3a4e7b91d003c45a1f2--b-d8c647b.base44.app"
  }
]

Code and sandbox

List branches

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Returns the app’s branches, newest first. Branches imported with Import a GitHub branch are included. While main branch protection is on, changes to main go through a branch.

By default only active branches are returned. Set include_merged to true to also get the ones already merged into main. Deleted branches are never listed, but Get branch still returns them. The list isn’t paginated.

This is limited to 300 requests per minute per app for each workspace’s personal API keys, so every key in a workspace shares one allowance. List branches and Get branch share it. Some workspaces have a different limit.

This endpoint accepts a personal API key belonging to a user with editor access to the app, including a read-only key. Workspace API keys are not accepted.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

GET

api

apps

{app_id}

branches

List branches

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/branches \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/apps/{app_id}/branches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/branches",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/branches"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/branches")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "68f1a2b3c4d5e6f708192a3b",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "branch_name": "add-contact-form",
    "status": "active",
    "run_state": {
      "state": "ready",
      "details": "Restoring checkpoint",
      "last_updated_date": "2026-09-28T10:18:40"
    },
    "code_state": "changed",
    "base_checkpoint_id": "6886b8d390dc7e2f4a2c91b3",
    "created_by_id": "68a0c1d2e3f4a5b6c7d8e9f0",
    "created_by_name": "Jane Doe",
    "created_date": "2026-09-28T10:15:00",
    "merged_at": "2026-09-29T08:02:11",
    "merged_by_id": "68a0c1d2e3f4a5b6c7d8e9f0",
    "static_preview_url": "https://preview--6820f3a4e7b91d003c45a1f2--b-d8c647b.base44.app"
  }
]

Authorizations

Authorization

string

header

required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

app_id

string

required

ID of the app whose branches to read.

Query Parameters

include_merged

boolean

default:false

Set to true to also return branches already merged into main.

Response

The app's branches, newest first.

string

required

ID of the branch.

Example:

"68f1a2b3c4d5e6f708192a3b"

app_id

string

required

ID of the app the branch belongs to.

Example:

"6820f3a4e7b91d003c45a1f2"

branch_name

string

required

Name of the branch.

Example:

"add-contact-form"

status

enum<string>

required

active while the branch can still be worked on, merged once it was merged into main, and deleted once it was deleted.

Available options:

active,

merged,

deleted

Example:

"active"

run_state

BranchRunState · object | null

required

State of the AI's work on the branch, or null if no turn has run on it yet.

Show child attributes

code_state

enum<string>

required

unchanged when the branch has no code changes of its own to merge into main. changed otherwise, including when Base44 can't tell yet.

Available options:

unchanged,

changed

Example:

"changed"

base_checkpoint_id

string | null

required

ID of the main checkpoint the branch started from, or null if the app had no checkpoint yet.

Example:

"6886b8d390dc7e2f4a2c91b3"

created_by_id

string

required

ID of the user who created the branch.

Example:

"68a0c1d2e3f4a5b6c7d8e9f0"

created_by_name

string | null

required

Display name of the user who created the branch, or the part of their email before the @ when they have no name. null when Base44 can't name them, for example when their account no longer exists.

Example:

"Jane Doe"

created_date

string<date-time>

required

When the branch was created, as a UTC timestamp in ISO 8601 format.

Example:

"2026-09-28T10:15:00"

merged_at

string<date-time> | null

required

When the branch was merged into main, as a UTC timestamp in ISO 8601 format, or null if it wasn't.

Example:

"2026-09-29T08:02:11"

merged_by_id

string | null

required

ID of the user who merged the branch, or null if it wasn't merged or Base44 doesn't know who did, as for a branch whose pull request was merged on GitHub.

Example:

"68a0c1d2e3f4a5b6c7d8e9f0"

static_preview_url

string

required

URL of the branch's preview. It shows the branch only while it's active and once it has been built.

Example:

"https://preview--6820f3a4e7b91d003c45a1f2--b-d8c647b.base44.app"

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

List branches

Authorizations

Path Parameters

Query Parameters

Response