Skip to main content
GET
Get branch

Authorizations

Authorization
string
header
required

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

Path Parameters

branch_id
string
required

ID of the branch, as returned by List branches.

app_id
string
required

ID of the app whose branches to read.

Response

The branch.

A branch of an app.

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

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"